你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
使用 PowerShell 将旧版直接对等互连转换为 Azure 资源
本文介绍如何使用 PowerShell cmdlet 将现有旧版直接对等互连转换为 Azure 资源。
如果需要，可以使用 Azure 门户完成本指南。
开始之前
使用 Azure PowerShell
若要运行 cmdlet，可以使用 Azure Cloud Shell（一个免费的交互式 shell）。 它预安装有常用 Azure 工具并将其配置与帐户一起使用。 选择“复制”以复制代码，并将其粘贴到 Cloud Shell。 然后选择 Enter 运行此代码。 可通过多种方式来启动 Cloud Shell：
| 启动方法 | 屏幕快照 |
|---|---|
| 在浏览器中打开 Cloud Shell。 |  |
| 选择 Azure 门户右上角工具栏上的“Cloud Shell”按钮。 |  |
如果不想使用 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 中的步骤操作。
将旧版直接对等互连转换为 Azure 资源
登录到 Azure 帐户，然后选择订阅
在开始配置之前，请安装并导入所需的模块。 你需要具有管理员权限才能在 PowerShell 中安装模块。
安装并导入 Az 模块。
Install-Module Az -AllowClobber Import-Module Az安装并导入 Az.Peering 模块。
Install-Module -Name Az.Peering -AllowClobber Import-Module Az.Peering使用此命令验证是否已正确导入模块：
Get-Module使用以下命令登录到 Azure 帐户：
Connect-AzAccount查看帐户的订阅，并选择要在其中创建对等互连的订阅。
Get-AzSubscription Select-AzSubscription -SubscriptionId "subscription-id"如果尚未有资源组，则在创建对等互连之前，必须先创建一个资源组。 为此，可以运行以下命令：
New-AzResourceGroup -Name "PeeringResourceGroup" -Location "Central US"
重要
如果尚未关联 ASN 和订阅，请按照关联对等 ASN 中的步骤进行操作。 请求对等互连时需要此操作。
注意
资源组的位置与选择设置对等互连的位置无关。
获取用于转换的旧版直接对等互连
此示例演示如何在西雅图对等互连位置获取旧版直接对等互连。
$legacyPeering = Get-AzLegacyPeering `
-Kind Direct -PeeringLocation "Seattle"
$legacyPeering
下面是示例响应：
Name :
Sku : Basic_Direct_Free
Kind : Direct
PeeringLocation : Seattle
UseForPeeringService : False
PeerAsn.Id :
Connection : ------------------------
PeeringDBFacilityId : 71
SessionPrefixIPv4 : 4.71.156.72/30
PeerSessionIPv4Address : 4.71.156.73
MicrosoftIPv4Address : 4.71.156.74
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
SessionPrefixIPv6 : 2001:1900:2100::1e10/126
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
BandwidthInMbps : 0
ProvisionedBandwidthInMbps : 20000
Connection : ------------------------
PeeringDBFacilityId : 71
SessionPrefixIPv4 : 4.68.70.140/30
PeerSessionIPv4Address : 4.68.70.141
MicrosoftIPv4Address : 4.68.70.142
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
SessionPrefixIPv6 : 2001:1900:4:3::cc/126
PeerSessionIPv6Address : 2001:1900:4:3::cd
MicrosoftIPv6Address : 2001:1900:4:3::ce
SessionStateV6 : Established
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
BandwidthInMbps : 0
ProvisionedBandwidthInMbps : 20000
ProvisioningState : Succeeded
转换旧版直接对等互连
重要
将旧版直接对等互连转换为 Azure 资源时，不支持修改。
使用这条命令可将旧版直接对等互连转换为 Azure 资源：
$legacyPeering[0] | New-AzPeering `
-Name "SeattleDirectPeering" `
-ResourceGroupName "PeeringResourceGroup" `
下面是示例响应：
Name : SeattleDirectPeering
Sku.Name : Basic_Direct_Free
Kind : Direct
Connections : {11, 11}
PeerAsn.Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{asnNumber}
UseForPeeringService : False
PeeringLocation : Seattle
ProvisioningState : Succeeded
Location : centralus
Id : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
Type : Microsoft.Peering/peerings
Tags : {}
其他资源
可以通过运行以下命令获取所有这些参数的详细说明：
Get-Help Get-AzPeering -detailed
后续步骤
- 使用 PowerShell 创建或修改直接对等互连。
- Internet 对等互连常见问题（常见问题解答）。