使用 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。
- 確認傳統和 Az Azure PowerShell 模組都已安裝在電腦本地上。 如需詳細資訊,請參閱 如何安裝及設定 Azure PowerShell。
- 開始設定之前,請確定您已經檢閱過必要條件、路由需求和工作流程。
- 請檢閱將 ExpressRoute 電路從傳統移至 Resource Manager 下提供的資訊。 請確定您已完整了解各項限制。
- 請確認電路在傳統部署模型中的運作完全正常。
- 請確定您擁有建立在 Resource Manager 部署模型中建立的資源群組。
移動 ExpressRoute 電路
步驟 1︰從傳統部署模型收集電路詳細資訊
登入 Azure 傳統環境並收集服務金鑰。
登入您的 Azure 帳戶。
Add-AzureAccount
選取適當的 Azure 訂用帳戶。
Select-AzureSubscription "<Enter Subscription Name here>"
匯入 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'
使用下列 Cmdlet 來取得所有 ExpressRoute 電路的服務金鑰。 在取得金鑰之後,請複製電路的「服務金鑰」,這個電路就是您想要移至 Resource Manager 部署模型的電路。
Get-AzureDedicatedCircuit
步驟 2:登入並建立資源群組
登入 Resource Manager 環境並建立新的資源群組。
登入您的 Azure Resource Manager 環境。
Connect-AzAccount
選取適當的 Azure 訂用帳戶。
Get-AzSubscription -SubscriptionName "<Enter Subscription Name here>" | Select-AzSubscription
修改下列程式碼片段以建立新的資源群組 (如果您尚未擁有資源群組)。
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 以存取這兩種部署模型︰
取得電路詳細資料。
$ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"
將 [允許傳統作業] 設定為 TRUE。
$ckt.AllowClassicOperations = $true
更新電路。 成功完成這項作業後,您就可以在傳統部署模型中檢視電路。
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt
執行下列 Cmdlet 以取得 ExpressRoute 電路的詳細資料。 您必須能夠看到列出的服務金鑰。
get-azurededicatedcircuit
您現在可以使用適用於傳統 VNet 的傳統部署模型命令,以及適用於 Resource Manager VNet 的 Resource Manager 命令,來管理 ExpressRoute 電路的連結。 下列文件會協助您管理 ExpressRoute 線路的連結︰
停用傳統部署模型的 ExpressRoute 電路存取
執行下列的 Cmdlet 以停止傳統部署模型的存取。
取得 ExpressRoute 電路的詳細資料。
$ckt = Get-AzExpressRouteCircuit -Name "DemoCkt" -ResourceGroupName "DemoRG"
將 [允許傳統作業] 設定為 FALSE。
$ckt.AllowClassicOperations = $false
更新電路。 成功完成這項作業後,您就不能在傳統部署模型中檢視電路。
Set-AzExpressRouteCircuit -ExpressRouteCircuit $ckt