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

在提交对等互连请求之前,应首先使用本文中的步骤将 ASN 与 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

如果不想使用 Azure Cloud Shell,则可以改为在本地安装 PowerShell。 如果选择在本地安装和使用 PowerShell,请务必安装最新版本的 Azure 资源管理器 PowerShell cmdlet。 PowerShell 命令频繁地更新。 你通常需要更新 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 变为“已注册”后,然后再继续。 执行命令后可能需要 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 的名称是唯一的。

对等方应确保在 PeeringDB 上有完整且up-to最新的配置文件。 在注册期间,我们使用此信息来验证对等方的详细信息,例如 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 变为“已批准”。 此批准可能需要长达 12 小时的时间。

修改 PeerAsn

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

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

删除 PeerAsn

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

后续步骤