使用 Azure Resource Manager 範本建立 ExpressRoute 線路

發行項
04/13/2023

了解如何使用 PowerShell 部署 Azure Resource Manager 範本，來建立 Azure ExpressRoute 線路。如需開發 Resource Manager 範本的詳細資訊，請參閱 Resource Manager 文件和範本參考。

開始之前

開始設定之前，請檢閱必要條件和工作流程。
確定您具有建立新網路資源的權限。如果您沒有正確的權限，請連絡您的帳戶管理員。
您可以在開始前先觀賞影片，以便更加了解步驟。

建立和佈建 ExpressRoute 線路

Azure 快速入門範本具有良好的 Resource Manager 範本集合。您可以使用其中一個現有範本來建立 ExpressRoute 線路。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "14062891962288443864"
    }
  },
  "parameters": {
    "circuitName": {
      "type": "string",
      "metadata": {
        "description": "This is the name of the ExpressRoute circuit"
      }
    },
    "serviceProviderName": {
      "type": "string",
      "metadata": {
        "description": "This is the name of the ExpressRoute Service Provider. It must exactly match one of the Service Providers from List ExpressRoute Service Providers API call."
      }
    },
    "peeringLocation": {
      "type": "string",
      "metadata": {
        "description": "This is the name of the peering location and not the ARM resource location. It must exactly match one of the available peering locations from List ExpressRoute Service Providers API call."
      }
    },
    "bandwidthInMbps": {
      "type": "int",
      "metadata": {
        "description": "This is the bandwidth in Mbps of the circuit being created. It must exactly match one of the available bandwidth offers List ExpressRoute Service Providers API call."
      }
    },
    "skuTier": {
      "type": "string",
      "defaultValue": "Standard",
      "allowedValues": [
        "Standard",
        "Premium"
      ],
      "metadata": {
        "description": "Chosen SKU Tier of ExpressRoute circuit. Choose from Premium or Standard SKU tiers."
      }
    },
    "skuFamily": {
      "type": "string",
      "defaultValue": "MeteredData",
      "allowedValues": [
        "MeteredData",
        "UnlimitedData"
      ],
      "metadata": {
        "description": "Chosen SKU family of ExpressRoute circuit. Choose from MeteredData or UnlimitedData SKU families."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Network/expressRouteCircuits",
      "apiVersion": "2021-02-01",
      "name": "[parameters('circuitName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[format('{0}_{1}', parameters('skuTier'), parameters('skuFamily'))]",
        "tier": "[parameters('skuTier')]",
        "family": "[parameters('skuFamily')]"
      },
      "properties": {
        "serviceProviderProperties": {
          "serviceProviderName": "[parameters('serviceProviderName')]",
          "peeringLocation": "[parameters('peeringLocation')]",
          "bandwidthInMbps": "[parameters('bandwidthInMbps')]"
        }
      }
    }
  ]
}

若要查看更多的相關範本，請在這裡選取。

若要部署範本來建立 ExpressRoute 線路：

選取下列程式碼區塊中的 [試用]，然後依照指示登入 Azure Cloud Shell。
```
$circuitName = Read-Host -Prompt "Enter a circuit name"
$location = Read-Host -Prompt "Enter the location (i.e. centralus)"
$resourceGroupName = "${circuitName}rg"
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.network/expressroute-circuit-create/azuredeploy.json"
$serviceProviderName = "Equinix"
$peeringLocation = "Silicon Valley"
$bandwidthInMbps = 500
$sku_tier = "Premium"
$sku_family = "MeteredData"

New-AzResourceGroup -Name $resourceGroupName -Location $location
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri -circuitName $circuitName -serviceProviderName $serviceProviderName -peeringLocation $peeringLocation -bandwidthInMbps $bandwidthInMbps -sku_tier $sku_tier -sku_family $sku_family

Write-Host "Press [ENTER] to continue ..."
```
- SKU 層會決定 ExpressRoute 線路是本機、標準或進階。您可以指定「本機」、「*標準」或「進階」。
- SKU 系列決定計費類型。您可以指定 [Metereddata] 以採用計量付費數據傳輸方案，選取 [Unlimiteddata] 以採用無限行動數據方案。您可以將計費類型從 Metereddata 變更為 Unlimiteddata，但無法將類型從 Unlimiteddata 變更為 Metereddata。「本機」線路僅限 [Unlimiteddata]。
- [對等位置] 是您與 Microsoft 對等互連的實體位置。
  
  重要
  
  [對等位置] 表示您與 Microsoft 對等互連的實體位置。這不會連結到「位置」屬性，這是指 Azure 網路資源提供者所在的地理位置。儘管它們並無關聯，但最好還是選擇地理位置靠近線路對等位置的網路資源提供者。
資源群組名稱是附加 rg 服務匯流排命名空間名稱。
選取 [複製] 來複製 PowerShell 指令碼。
以滑鼠右鍵按一下殼層主控台，然後選取 [貼上]。

建立事件中樞需要幾分鐘的時間。

Azure PowerShell 用來在本教學課程中部署範本。如需其他範本部署方法，請參閱：

取消佈建和刪除 ExpressRoute 線路

您可以選取刪除圖示，刪除 ExpressRoute 線路。請注意下列資訊︰

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

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

$circuitName = Read-Host -Prompt "Enter the same circuit name that you used earlier"
$resourceGroupName = "${circuitName}rg"

Remove-AzExpressRouteCircuit -ResourceGroupName $resourceGroupName -Name $circuitName

下一步

建立線路後，繼續執行下列步驟：

共用方式為

使用 Azure Resource Manager 範本建立 ExpressRoute 線路

開始之前

建立和佈建 ExpressRoute 線路

取消佈建和刪除 ExpressRoute 線路

下一步

意見反應

其他資源