使用 PowerShell 将 ExpressRoute 线路从经典部署模型转移到资源管理器部署模型

要将 ExpressRoute 线路同时用于经典部署模型和 Resource Manager 部署模型,必须将该线路移动到 Resource Manager 部署模型中。 以下部分可帮助使用 PowerShell 转移线路。

准备阶段

本文中的步骤和示例使用 Azure PowerShell Az 模块。 若要在计算机上本地安装 Az 模块,请参阅安装 Azure PowerShell。 若要详细了解新 Az 模块,请参阅新 Azure Powershell Az 模块简介。 PowerShell cmdlet 经常更新。 如果未运行最新版本,在说明中指定的值可能无法使用。 若要在系统上查找已安装的 PowerShell 版本,请使用 Get-Module -ListAvailable Az cmdlet。

移动 ExpressRoute 线路

步骤 1:从经典部署模型收集线路详细信息

登录 Azure 经典环境并收集服务密钥。

  1. 登录到 Azure 帐户。

    Add-AzureAccount
    
  2. 选择相应的 Azure 订阅。

    Select-AzureSubscription "<Enter Subscription Name here>"
    
  3. 为 Azure 和 ExpressRoute 导入 PowerShell 模块。

    Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.1.1\Azure\Azure.psd1'
    Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.1.1\ExpressRoute\ExpressRoute.psd1'
    
  4. 使用下面的 cmdlet 获取所有 ExpressRoute 线路的服务密钥。 检索密钥后,请复制要移动到 Resource Manager 部署模型的线路的 服务密钥

    Get-AzureDedicatedCircuit
    

步骤 2:登录并创建资源组

登录 Resource Manager 环境并创建新的资源组。

  1. 登录 Azure Resource Manager 环境。

    Connect-AzAccount -Environment AzureChinaCloud
    
  2. 选择相应的 Azure 订阅。

    Get-AzSubscription -SubscriptionName "<Enter Subscription Name here>" | Select-AzSubscription
    
  3. 如果还没有资源组,请修改下面的片段,创建新的资源组。

    New-AzResourceGroup -Name "DemoRG" -Location "China East"
    

步骤 3:将 ExpressRoute 线路转移到 Resource Manager 部署模型

现在,可以将 ExpressRoute 线路从经典部署模型移动到 Resource Manager 部署模型。 在继续下之前,请先查看将 ExpressRoute 线路从经典部署模型移动到 Resource Manager 部署模型中提供的信息。

若要移动线路,请修改并运行以下代码片段:

Move-AzExpressRouteCircuit -Name "MyCircuit" -ResourceGroupName "DemoRG" -Location "China East" -ServiceKey "<Service-key>"

在经典模式下,ExpressRoute 线路没有绑定到区域的概念。 但是,在资源管理器中,每个资源都需要映射到 Azure 区域。 从技术上来讲,Move-AzExpressRouteCircuit cmdlet 中指定的区域可以是任何区域。 对组织来说,建议选择一个最能代表对等位置的区域。

注意

  • 将经典 ExpressRoute 线路移到资源管理器部署模型后,它将默认具有对经典部署模型和资源管理器部署模型的访问权限。
  • 在上一 cmdlet 中列出新名称将用于处理资源。 线路实质上已重命名。

修改线路访问权限

为两种部署模型启用 ExpressRoute 线路访问权限

可为在资源管理器部署模型中创建的 ExpressRoute 线路启用对经典部署模型的访问权限。 运行以下 cmdlet 启用对两种部署模型的访问权限:

  1. 获取线路详细信息。

    $ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"
    
  2. 将“允许经典操作”设置为 TRUE。

    $ckt.AllowClassicOperations = $true
    
  3. 更新线路。 成功完成此操作后,可以在经典部署模型中查看线路。

    Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
    
  4. 运行以下 cmdlet 获取 ExpressRoute 线路的详细信息。 服务密钥必须已列出。

    get-azurededicatedcircuit
    
  5. 现在,可以使用适用于经典 VNet 的经典部署模型命令以及适用于 Resource Manager VNet 的 Resource Manager 命令来管理到 ExpressRoute 线路的链接。 以下文章可帮助管理 ExpressRoute 线路的链接:

禁止 ExpressRoute 线路访问经典部署模型

运行以下 cmdlet 可禁止访问经典部署模型。

  1. 获取 ExpressRoute 线路的详细信息。

    $ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"
    
  2. 将“允许经典操作”设置为 FALSE。

    $ckt.AllowClassicOperations = $false
    
  3. 更新线路。 成功完成此操作后,将无法在经典部署模型中查看线路。

    Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
    

后续步骤