使用 PowerShell 修改 ExpressRoute 線路 (傳統)

發行項
06/01/2023

本文將逐步引導您檢查狀態、更新或刪除，以及取消佈建 ExpressRoute 傳統部署模型線路。本文適用於傳統部署模型。

重要

從 2017 年 3 月 1 日起，您便無法在傳統部署模型中建立新的 ExpressRoute 線路。

您可以將現有 ExpressRoute 線路從傳統部署模型移至 Resource Manager 部署模型﹐而不會遇到任何連線中斷情形。如需詳細資訊，請參閱移動現有線路。
將 allowClassicOperations 設為 TRUE﹐即可連接到傳統部署模型中的虛擬網路。

使用下列連結﹐在 Resource Manager 部署模型中建立及管理 ExpressRoute 線路：

關於 Azure 部署模型

Azure 目前使用兩種部署模型：Resource Manager 和傳統。兩個模型彼此無法完全相容。開始之前，您必須知道您想要使用哪一個模型。如需部署模型的資訊，請參閱了解部署模型。如果您不熟悉 Azure，建議使用 Azure Resource Manager 部署模型。

開始之前

安裝最新版本的 Azure 服務管理（SM） PowerShell 模組和 ExpressRoute 模組。您無法使用 Azure CloudShell 環境來執行 SM 模組。

使用安裝服務管理模組一文中的指示來安裝 Azure 服務管理模組。如果您已安裝 Az 或 RM 模組，請務必使用 '-AllowClobber'。

匯入已安裝的模組。使用下列範例時，請調整路徑以反映已安裝 PowerShell 模組的位置和版本。

Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.3.0\Azure.psd1'
Import-Module 'C:\Program Files\WindowsPowerShell\Modules\Azure\5.3.0\ExpressRoute\ExpressRoute.psd1'

若要登入您的 Azure 帳戶，請以提高的權限開啟 PowerShell 主控台並連線到您的帳戶。使用下列範例可協助您使用服務管理模組進行連線：
```
Add-AzureAccount
```

取得線路狀態

您隨時可以使用 Get-AzureCircuit Cmdlet 擷取此資訊。執行呼叫時，若未指定任何參數，將會列出所有線路。

Get-AzureDedicatedCircuit

Bandwidth                        : 200
CircuitName                      : MyTestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

Bandwidth                        : 1000
CircuitName                      : MyAsiaCircuit
Location                         : Singapore
ServiceKey                       : #################################
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

您可以將服務金鑰當作參數傳遞給呼叫，以取得特定 ExpressRoute 線路的詳細資訊。

Get-AzureDedicatedCircuit -ServiceKey "*********************************"

Bandwidth                        : 200
CircuitName                      : MyTestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

您可以執行下列範例來取得所有參數的詳細描述：

get-help get-azurededicatedcircuit -detailed

修改線路

您可以修改 ExpressRoute 線路的某些屬性，而不會影響連線。

您可以執行下列工作，而無需中途停機：

啟用或停用 ExpressRoute 線路的 ExpressRoute 進階附加元件。
只要連接埠有可用的容量，就增加 ExpressRoute 線路的頻寬。不支援將線路的頻寬降級。
將計量方案從 [計量付費] 變更為 [無限制]。不支援將計量方案從 [無限制資料] 變更為 [已計量資料]。
您可以啟用和停用 [允許傳統作業] 。

如需限制的詳細資訊，請參閱 ExpressRoute 常見問題集。

啟用 ExpressRoute 進階附加元件

您可以使用下列 PowerShell Cmdlet，為現有的線路啟用 ExpressRoute Premium 附加元件：

Set-AzureDedicatedCircuitProperties -ServiceKey "*********************************" -Sku Premium

Bandwidth                        : 1000
CircuitName                      : TestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Premium
Status                           : Enabled

您的線路現在將啟用 ExpressRoute Premium 附加功能。一旦順利執行命令，就會立即開始針對進階附加元件功能計費。

停用 ExpressRoute 進階附加元件

重要

如果您使用的資源超出標準線路所允許的數量，這項作業可能會失敗。

考量

從高階降級為標準之前，請確定連結至線路的虛擬網路數目小於 10。如果您不這樣做，更新要求就會失敗，且會被以進階費率計費。
您必須取消連結其他地理政治區域中的所有虛擬網路。如果您不這樣做，更新要求就會失敗，且會被以進階費率計費。
就私用對等設定而言，路由表必須少於 4000 個路由。如果路由表大小超過 4000 個路由，BGP 工作階段將會中斷，而且在通告的首碼數目降到 4000 以下之前不會重新啟用。

停用進階附加元件

您可以使用下列 PowerShell Cmdlet，為現有的線路停用 ExpressRoute Premium 附加元件：


Set-AzureDedicatedCircuitProperties -ServiceKey "*********************************" -Sku Standard

Bandwidth                        : 1000
CircuitName                      : TestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

更新 ExpressRoute 線路頻寬

請查閱 ExpressRoute 常見問題集，以取得提供者支援的頻寬選項。只要實體連接埠 (您的線路在此建立) 允許，您可以選擇大於現有線路的任何大小。

重要

如果現有的連接埠上沒有足夠的容量，您可能必須重新建立 ExpressRoute 線路。如果該位置已無額外的容量，您無法升級線路。

降低 ExpressRoute 線路的頻寬時必須中斷運作。頻寬降級需要取消佈建 ExpressRoute 線路，然後重新佈建新的 ExpressRoute 線路。

調整電路大小

一旦決定需要的大小後，您可以使用下列命令來調整線路大小。

Set-AzureDedicatedCircuitProperties -ServiceKey ********************************* -Bandwidth 1000

Bandwidth                        : 1000
CircuitName                      : TestCircuit
Location                         : Silicon Valley
ServiceKey                       : *********************************
ServiceProviderName              : equinix
ServiceProviderProvisioningState : Provisioned
Sku                              : Standard
Status                           : Enabled

一旦在 Microsoft 端增加您的線路大小，您必須連絡連線提供者，將他們的設定更新為符合這項變更。從這個階段起，會開始以更新後的頻寬選項計算費用。

如果增加線路頻寬時出現下列錯誤，則表示建立現有線路的實體連接埠所剩的頻寬不足。您必須刪除此線路，並建立所需大小的新線路。

Set-AzureDedicatedCircuitProperties : InvalidOperation : Insufficient bandwidth available to perform this circuit
update operation
At line:1 char:1
+ Set-AzureDedicatedCircuitProperties -ServiceKey ********************* ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  + CategoryInfo          : CloseError: (:) [Set-AzureDedicatedCircuitProperties], CloudException
  + FullyQualifiedErrorId : Microsoft.WindowsAzure.Commands.ExpressRoute.SetAzureDedicatedCircuitPropertiesCommand

取消佈建及刪除線路

考量

您必須取消連結 ExpressRoute 線路的所有虛擬網路，此作業才會成功。如果此作業失敗，請檢查您是否有任何虛擬網路連結至線路。
如果 ExpressRoute 線路服務提供者佈建狀態為 Provisioning 或 Provisioned，您就必須與服務提供者一起合作，取消佈建他們那邊的線路。我們會繼續保留資源並向您收取費用，直到線路服務提供者完成取消佈建並通知我們。
若服務提供者已取消佈建線路 (服務提供者佈建狀態設定為 [未佈建])，您便可以刪除線路。這樣會停止針對線路計費。

刪除電路

您可以執行下列命令來刪除 ExpressRoute 線路：

Remove-AzureDedicatedCircuit -ServiceKey "*********************************"

共用方式為