使用 Azure 资源管理器模板创建 ExpressRoute 线路

项目
05/01/2023

了解如何使用 Azure PowerShell 部署 Azure 资源管理器模板，以便创建 ExpressRoute 线路。有关开发资源管理器模板的详细信息，请参阅资源管理器文档和模板参考。

准备阶段

在开始配置之前，请查看先决条件和工作流。
确保有权创建新的网络资源。如果没有适当的权限，请与帐户管理员联系。

创建和预配 ExpressRoute 线路

Azure 快速入门模板有许多资源管理器模板。请使用某个现有模板来创建 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。
```
$circuitName = Read-Host -Prompt "Enter a circuit name"
$location = Read-Host -Prompt "Enter the location (i.e. chinaeast)"
$resourceGroupName = "${circuitName}rg"
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.network/expressroute-circuit-create/azuredeploy.json"
$serviceProviderName = "Shanghai Telecom Ethernet"
$peeringLocation = "Shanghai"
$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 建立对等互连的实际位置。此位置与“Location”属性没有关系，后者指的是 Azure 网络资源提供商所在的地理位置。尽管两者之间没有关系，但最好是选择地理上与线路对等互连位置靠近的网络资源提供商。
资源组名称是追加了 rg 的服务总线命名空间名称。
选择“复制”以复制 PowerShell 脚本。
右键单击 shell 控制台并选择“粘贴” 。

创建事件中心需要一些时间。

在本教程中，请使用 Azure PowerShell 来部署模板。如需其他模板部署方法，请参阅：

取消预配和删除 ExpressRoute 线路

可以通过选择“删除” 图标来删除 ExpressRoute 线路。请注意以下信息：

必须取消所有虚拟网络与 ExpressRoute 线路的链接。如果此操作失败，请检查是否有虚拟网络链接到了该线路。
如果 ExpressRoute 线路服务提供商预配状态为“正在预配” 或“已预配” ，则必须与服务提供商合作，在他们一端取消预配线路。在服务提供商取消对线路的预配并通知我们之前，我们会继续保留资源并收费。
如果服务提供商已取消设置线路（服务提供商预配状态设置为“未预配” ），可以删除线路。这样就会停止对线路的计费。

可以通过运行以下 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 资源管理器模板创建 ExpressRoute 线路

准备阶段

创建和预配 ExpressRoute 线路

取消预配和删除 ExpressRoute 线路

后续步骤

其他资源