你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

使用 PowerShell 将对等 ASN 关联到 Azure 订阅

在提交对等互连请求之前,应首先使用本文中的步骤将 ASN 与 Azure 订阅相关联。

如果需要,可以使用Azure 门户完成本指南

使用 Azure PowerShell

若要运行 cmdlet,可以使用 Azure Cloud Shell(一个免费的交互式 shell)。 它预安装有常用 Azure 工具并将其配置与帐户一起使用。 选择“复制”以复制代码,并将其粘贴到 Cloud Shell。 然后选择 Enter 运行此代码。 可通过多种方式来启动 Cloud Shell:

启动方法 屏幕快照
在浏览器中打开 Cloud Shell。 https://shell.azure.com/powershell
选择 Azure 门户右上角工具栏上的“Cloud Shell”按钮。 Cloud Shell in the portal

如果不想使用 Azure Cloud Shell,则可以改为在本地安装 PowerShell。 如果选择在本地安装和使用 PowerShell,请务必安装最新版本的 Azure 资源管理器 PowerShell cmdlet。 PowerShell cmdlet 经常更新。 你通常需要更新 PowerShell cmdlet 才能获取最新的功能。 否则,可能会遇到问题。

若要查找你在本地运行的 PowerShell 版本,请使用“Get-Module -ListAvailable Az”cmdlet。 若要更新,请参阅安装 Azure PowerShell 模块。 有关详细信息,请参阅如何安装和配置 Azure PowerShell

如果在 macOS 上使用 PowerShell,请按照在 macOS 上安装 PowerShell 中的步骤操作。

创建 PeerASN 以将 ASN 与 Azure 订阅关联

登录到 Azure 帐户,然后选择订阅

在开始配置之前,请安装并导入所需的模块。 你需要具有管理员权限才能在 PowerShell 中安装模块。

  1. 安装并导入 Az 模块。

    Install-Module Az -AllowClobber
    Import-Module Az
    
  2. 安装并导入 Az.Peering 模块。

    Install-Module -Name Az.Peering -AllowClobber
    Import-Module Az.Peering
    
  3. 使用此命令验证是否已正确导入模块:

    Get-Module
    
  4. 使用以下命令登录到 Azure 帐户:

    Connect-AzAccount
    
  5. 查看帐户的订阅,并选择要在其中创建对等互连的订阅。

    Get-AzSubscription
    Select-AzSubscription -SubscriptionId "subscription-id"
    
  6. 如果尚未有资源组,则在创建对等互连之前,必须先创建一个资源组。 为此,可以运行以下命令:

    New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"
    

重要

如果尚未关联 ASN 和订阅,请按照关联对等 ASN 中的步骤进行操作。 请求对等互连时需要此操作。

注意

资源组的位置与选择设置对等互连的位置无关。  

注册对等互连资源提供程序

使用 Register-AzResourceProvider 在订阅中注册对等互连资源提供程序。 如果不执行此操作,则无法访问设置对等互连所需的 Azure 资源。

Register-AzResourceProvider -ProviderNamespace Microsoft.Peering

可以使用 Get-AzResourceProvider 检查注册状态

Get-AzResourceProvider -ProviderNamespace Microsoft.Peering

重要

等待“RegistrationState”变为“Registered”,然后再继续。 执行命令后,可能需要 5 到 30 分钟的等待时间。

更新与此订阅关联的对等体信息

使用 New-AzPeerAsn 更新与此订阅关联的对等信息:

$contactDetails = New-AzPeerAsnContactDetail -Role Noc -Email "noc@contoso.com" -Phone "+1 (555) 555-5555"
New-AzPeerAsn -Name "Contoso_1234" -PeerName "Contoso" -PeerAsn 1234 -ContactDetail $contactDetails

注意

-Name 对应于资源名称,可以是所选择的任何内容。 但是,-peerName 对应于公司名称,需要尽可能与 PeeringDB 配置文件接近。 请注意,-peerName 仅支持字符 a-z、A-Z 和空格。

一个订阅可以有多个 ASN。 更新每个 ASN 的对等互连信息。 请确保每个 ASN 的“name”都独一无二。

对等体应在 PeeringDB 上具有完整且最新的配置文件。 在注册过程中,我们使用这些信息来验证对等体的详细信息(例如 NOC 信息、技术联系信息以及它们在对等设施中是否存在,等等)。

在输出中代替 {subscriptionId} 时,将显示实际的订阅 ID。

查看 PeerASN 的状态

使用 Get-AzPeerAsn 检查 ASN 验证状态:

Get-AzPeerAsn

下面是示例响应:

PeerContactInfo : Microsoft.Azure.PowerShell.Cmdlets.Peering.Models.PSContactInfo
PeerName        : Contoso
ValidationState : Approved
PeerAsnProperty : 1234
Name            : Contoso_1234
Id              : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/Contoso_1234
Type            : Microsoft.Peering/peerAsns

重要

在提交对等互连请求之前,等待 ValidationState 变成“Approved”。 此批准最多可能需要 12 小时。

修改 PeerAsn

可以使用 Set-AzPeerAsn 随时修改 NOC 联系信息:

Set-AzPeerAsn -Name Contoso_1234 -Email "newemail@test.com" -Phone "1800-000-0000"

删除 PeerAsn

目前不支持删除 PeerASN。 如果需要删除 PeerASN,请联系 Microsoft 对等互连

后续步骤