使用 PowerShell 將 ExpressRoute 線路從傳統部署模型移至 Resource Manager 部署模型

  • 發行項

若要在傳統和 Resource Manager 兩種部署模型中使用 ExpressRoute，您必須將電路移至 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

  2. 選取適當的 Azure 訂用帳戶。

    Get-AzSubscription -SubscriptionName "<Enter Subscription Name here>" | Select-AzSubscription

  3. 修改下列程式碼片段以建立新的資源群組 (如果您尚未擁有資源群組)。

    New-AzResourceGroup -Name "DemoRG" -Location "West US"

步驟 3：將 ExpressRoute 電路移至 Resource Manager 部署模型

您已準備就緒，可將 ExpressRoute 電路從傳統部署模型移至 Resource Manager 部署模型。 更進一步之前，請先檢閱將 ExpressRoute 電路從傳統移至 Resource Manager 部署模型下提供的資訊。

若要移動電路，請修改並執行下列程式碼片段：

Move-AzExpressRouteCircuit -Name "MyCircuit" -ResourceGroupName "DemoRG" -Location "West US" -ServiceKey "<Service-key>"

在傳統模式中，ExpressRoute 電路沒有繫結至區域的概念。 不過，在 Resource Manager 中，每個資源都必須對應至 Azure 區域。 Move-AzExpressRouteCircuit Cmdlet 中指定的區域嚴格來說可以是任何區域。 基於組織目的，您可能想要選擇最能代表您對等互連位置的區域。

注意

  • 將傳統 ExpressRoute 線路移至 Resource Manager 部署模型之後，其依預設將可同時存取傳統和 Resource Manager 部署模型。
  • 列在前一個 Cmdlet 中的新名稱會用來處理資源。 電路基本上會重新命名。

修改電路存取

為兩種部署模型啟用 ExpressRoute 電路存取

您可以為在 Resource Manager 部署模型中建立的 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

下一步