快速入門：使用 Azure CLI 建立和修改 ExpressRoute 線路

發行項
03/10/2024

本快速入門說明如何使用命令行介面（CLI）建立 Azure ExpressRoute 線路。本文也會說明如何檢查狀態、更新或刪除和取消布建線路。

Diagram of ExpressRoute circuit deployment environment using Azure CLI.

必要條件

開始設定之前，請先檢閱必要條件和工作流程。
具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
安裝最新版的 CLI 命令（2.0 或更新版本）。如需安裝 CLI 命令的相關信息，請參閱安裝 Azure CLI 和開始使用 Azure CLI。

Azure Cloud Shell

Azure Cloud Shell 是裝載於 Azure 中的互動式殼層環境，可在瀏覽器中使用。您可以使用 Bash 或 PowerShell 搭配 Cloud Shell，與 Azure 服務共同使用。您可以使用 Cloud Shell 預先安裝的命令，執行本文提到的程式碼，而不必在本機環境上安裝任何工具。

要啟動 Azure Cloud Shell：

選項	範例/連結
選取程式碼或命令區塊右上角的 [試試看]。選取 [試試看] 並不會自動將程式碼或命令複製到 Cloud Shell 中。
請前往 https://shell.azure.com，或選取 [啟動 Cloud Shell] 按鈕，在瀏覽器中開啟 Cloud Shell。
選取 Azure 入口網站右上方功能表列上的 [Cloud Shell] 按鈕。

若要使用 Azure Cloud Shell：

啟動 Cloud Shell。
選取程式碼區塊 (或命令區塊) 上的 [複製] 按鈕以複製程式碼或命令。
透過在 Windows 和 Linux 上選取 Ctrl+Shift+V；或在 macOS 上選取 Cmd+Shift+V，將程式碼或命令貼到 Cloud Shell 工作階段中。
選取 Enter 鍵執行程式碼或命令。

建立及布建 ExpressRoute 線路

若要開始您的組態，請登入您的 Azure 帳戶。如果您使用 Cloud Shell 試用，則會自動登入。使用下列範例來協助您連接：

az login

檢查帳戶的訂用帳戶。

az account list

選取您想要建立 ExpressRoute 線路的訂用帳戶。

az account set --subscription "<subscription ID>"

取得支援的提供者、位置和頻寬清單

建立 ExpressRoute 線路之前，您需要支援的連線提供者、位置和頻寬選項清單。 CLI 命令 az network express-route list-service-providers 會傳回此資訊，您可以在後續步驟中使用：

az network express-route list-service-providers

回應如下列範例所示：

[
  {
    "bandwidthsOffered": [
      {
        "offerName": "50Mbps",
        "valueInMbps": 50
      },
      {
        "offerName": "100Mbps",
        "valueInMbps": 100
      },
      {
        "offerName": "200Mbps",
        "valueInMbps": 200
      },
      {
        "offerName": "500Mbps",
        "valueInMbps": 500
      },
      {
        "offerName": "1Gbps",
        "valueInMbps": 1000
      },
      {
        "offerName": "2Gbps",
        "valueInMbps": 2000
      },
      {
        "offerName": "5Gbps",
        "valueInMbps": 5000
      },
      {
        "offerName": "10Gbps",
        "valueInMbps": 10000
      }
    ],
    "id": "/subscriptions//resourceGroups//providers/Microsoft.Network/expressRouteServiceProviders/",
    "location": null,
    "name": "AARNet",
    "peeringLocations": [
      "Melbourne",
      "Sydney"
    ],
    "provisioningState": "Succeeded",
    "resourceGroup": "",
    "tags": null,
    "type": "Microsoft.Network/expressRouteServiceProviders"
  },

檢查回應以查看您的連線提供者是否已列出。記下下列資訊，您在建立線路時需要此資訊：

名稱
PeeringLocations
BandwidthsOffered

您現在已準備好建立 ExpressRoute 線路。

建立 ExpressRoute 線路

重要

您的 ExpressRoute 線路會從發出服務金鑰的那一刻起計費。當連線提供者準備好布建線路時，請執行這項作業。

如果您還沒有資源群組，您必須先建立一個資源群組，才能建立 ExpressRoute 線路。您可以執行下列命令來建立資源群組：

az group create -n ExpressRouteResourceGroup -l "West US"

下列範例示範如何透過矽谷的 Equinix 建立 200 Mbps ExpressRoute 線路。如果您使用不同的提供者和不同的設定，請在提出要求時取代該資訊。

請確定您指定正確的 SKU 層和 SKU 系列：

SKU 層會判斷 ExpressRoute 線路是本機、標準或進階版。您可以指定 Local、*Standard 或 進階版。
SKU 系列會決定計費類型。您可以為計量數據計劃指定 MeteredData，併為無限制的數據計劃指定 UnlimitedData。您可以將計費類型從 MeteredData 變更為 UnlimitedData，但無法將類型從 UnlimitedData 變更為 MeteredData。本機線路僅限 UnlimitedData。

您的 ExpressRoute 線路會從發出服務金鑰的那一刻起計費。下列範例是新服務金鑰的要求：

az network express-route create --bandwidth 200 -n MyCircuit --peering-location "Silicon Valley" -g ExpressRouteResourceGroup --provider "Equinix" -l "West US" --sku-family MeteredData --sku-tier Standard

回應包含服務金鑰。

列出所有 ExpressRoute 線路

若要取得您所建立的所有 ExpressRoute 線路清單，請執行 az network express-route list 命令。您可以使用此命令隨時擷取此資訊。若要列出所有線路，請呼叫不含參數。

az network express-route list

您的服務金鑰會列在 回應的 ServiceKey 欄位中。

"allowClassicOperations": false,
"authorizations": [],
"circuitProvisioningState": "Enabled",
"etag": "W/\"1262c492-ffef-4a63-95a8-a6002736b8c4\"",
"gatewayManagerEtag": null,
"id": "/subscriptions/81ab786c-56eb-4a4d-bb5f-f60329772466/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/MyCircuit",
"location": "westus",
"name": "MyCircuit",
"peerings": [],
"provisioningState": "Succeeded",
"resourceGroup": "ExpressRouteResourceGroup",
"serviceKey": "1d05cf70-1db5-419f-ad86-1ca62c3c125b",
"serviceProviderNotes": null,
"serviceProviderProperties": {
  "bandwidthInMbps": 200,
  "peeringLocation": "Silicon Valley",
  "serviceProviderName": "Equinix"
},
"serviceProviderProvisioningState": "NotProvisioned",
"sku": {
  "family": "UnlimitedData",
  "name": "Standard_MeteredData",
  "tier": "Standard"
},
"tags": null,
"type": "Microsoft.Network/expressRouteCircuits]

您可以使用 '-h' 參數執行命令，以取得所有參數的詳細描述。

az network express-route list -h

將服務金鑰傳送至您的連線提供者以進行佈建

'ServiceProviderProvisioningState' 提供服務提供者端布建目前狀態的相關信息。狀態提供 Microsoft 端的狀態。如需詳細資訊，請參閱工作流程一文。

當您建立新的 ExpressRoute 線路時，線路會是下列狀態：

"serviceProviderProvisioningState": "NotProvisioned"
"circuitProvisioningState": "Enabled"

當連線提供者目前為您啟用時，線路會變更為下列狀態：

"serviceProviderProvisioningState": "Provisioning"
"circuitProvisioningState": "Enabled"

若要使用 ExpressRoute 線路，它必須處於下列狀態：

"serviceProviderProvisioningState": "Provisioned"
"circuitProvisioningState": "Enabled

定期檢查線路金鑰的狀態和狀態

檢查服務金鑰的狀態和狀態，可讓您知道提供者何時佈建線路。設定線路之後， ServiceProviderProvisioningState 會顯示為已布建，如下列範例所示：

az network express-route show --resource-group ExpressRouteResourceGroup --name MyCircuit

回應如下列範例所示：

"allowClassicOperations": false,
"authorizations": [],
"circuitProvisioningState": "Enabled",
"etag": "W/\"1262c492-ffef-4a63-95a8-a6002736b8c4\"",
"gatewayManagerEtag": null,
"id": "/subscriptions/81ab786c-56eb-4a4d-bb5f-f60329772466/resourceGroups/ExpressRouteResourceGroup/providers/Microsoft.Network/expressRouteCircuits/MyCircuit",
"location": "westus",
"name": "MyCircuit",
"peerings": [],
"provisioningState": "Succeeded",
"resourceGroup": "ExpressRouteResourceGroup",
"serviceKey": "1d05cf70-1db5-419f-ad86-1ca62c3c125b",
"serviceProviderNotes": null,
"serviceProviderProperties": {
  "bandwidthInMbps": 200,
  "peeringLocation": "Silicon Valley",
  "serviceProviderName": "Equinix"
},
"serviceProviderProvisioningState": "NotProvisioned",
"sku": {
  "family": "UnlimitedData",
  "name": "Standard_MeteredData",
  "tier": "Standard"
},
"tags": null,
"type": "Microsoft.Network/expressRouteCircuits]

建立路由設定

如需逐步指示，請參閱 ExpressRoute 線路路由設定一文，以建立和修改線路對等互連。

重要

這些指示僅適用於使用提供第 2 層連線服務的服務提供者所建立的線路。如果您使用提供受控第 3 層服務的服務提供者（通常是 IP VPN，例如 MPLS），您的連線提供者會為您設定和管理路由。

將虛擬網路連結到 ExpressRoute 線路

接下來，將虛擬網路連結至 ExpressRoute 線路。使用將虛擬網路連結至 ExpressRoute 線路一文。

修改 ExpressRoute 線路

您可以修改 ExpressRoute 線路的某些屬性，而不會影響連線。您可以進行下列變更，而不需要停機：

您可以啟用或停用 ExpressRoute 線路的 ExpressRoute 進階附加元件。
您可以增加 ExpressRoute 線路的頻寬，前提是埠上有可用的容量。不過，不支援將線路的頻寬降級。
您可以將計量計劃從計量資料變更為無限制數據。不過，不支援將計量計劃從無限制數據變更為計量數據。
您可以啟用和停用 [允許傳統作業] 。

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

啟用 ExpressRoute 進階附加元件

您可以使用下列命令，為您的現有線路啟用 ExpressRoute 進階附加元件：

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Premium

線路現在已啟用 ExpressRoute 進階附加元件功能。一旦命令成功執行，我們就會開始為您收取進階附加元件功能的帳單。

停用 ExpressRoute 進階附加元件

重要

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

停用 ExpressRoute 進階附加元件之前，請先瞭解下列準則：

從進階降級為標準之前，您必須確定連結至線路的虛擬網路數目小於 10。如果您不這樣做，更新要求就會失敗，且我們會以進階費率計費。
其他地理政治區域中的所有虛擬網路都必須先取消連結。如果您未移除連結，您的更新要求會失敗，我們會繼續以進階費率向您收費。
就私用對等設定而言，路由表必須少於 4000 個路由。如果您的路由表大小大於 4,000 個路由，BGP 會話就會卸除。 BGP 會話在公告前置詞數目低於 4,000 之前不會重新建立。

您可以使用下列範例來停用現有線路的 ExpressRoute 進階附加元件：

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-tier Standard

更新 ExpressRoute 線路頻寬

如需提供者支持的頻寬選項，請查看 ExpressRoute 常見問題。您可以挑選大於現有線路大小的任何大小。

重要

如果現有埠的容量不足，您可能需要重新建立 ExpressRoute 線路。如果該位置已無額外的容量，您無法升級線路。

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

決定您需要的大小之後，請使用下列命令調整線路的大小：

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --bandwidth 1000

您的線路會在 Microsoft 端升級。接下來，您必須連絡連線提供者，以更新其端的設定，以符合這項變更。進行此通知之後，我們會開始為您收取更新頻寬選項的帳單。

將 SKU 從計量移至無限制

您可以使用下列範例來變更 ExpressRoute 線路的 SKU：

az network express-route update -n MyCircuit -g ExpressRouteResourceGroup --sku-family UnlimitedData

控制傳統和 Resource Manager 環境的存取

檢閱將 ExpressRoute 線路從傳統移至 Resource Manager 部署模型中的指示。

取消布建 ExpressRoute 線路

若要取消布建和刪除 ExpressRoute 線路，請確定您瞭解下列準則：

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

清除資源

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

az network express-route delete  -n MyCircuit -g ExpressRouteResourceGroup

下一步

建立線路並與您的提供者布建之後，請繼續進行下一個步驟來設定對等互連：

建立和修改 ExpressRoute 線路的路由