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

使用 PowerShell 创建或修改 Exchange 对等互连

项目
03/25/2023

本文介绍如何使用 PowerShell cmdlet 和资源管理器部署模型创建 Microsoft Exchange 对等互连。本文还介绍如何查看资源状态，以及如何更新、删除和取消预配资源。

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

开始之前

在开始配置之前，请查看先决条件和 Exchange 对等互连演练。
如果已经与 Microsoft 建立了 Exchange 对等互连，但尚未转换为 Azure 资源，请参阅使用 PowerShell 将旧版 Exchange 对等互连转换为 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 中的步骤操作。

创建和预配 Exchange 对等互连

在开始配置之前，请安装并导入所需的模块。你需要具有管理员权限才能在 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 中的步骤进行操作。请求对等互连时需要此操作。

注意

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

获取 Exchange 对等互连支持的对等互连位置的列表

PowerShell cmdlet Get-AzPeeringLocation 返回具有必需参数 Kind 的对等互连位置的列表，你将在后续步骤中用到该参数。

Get-AzPeeringLocation -Kind "Exchange"

Exchange 对等互连位置包含以下字段：

ExchangeName
PeeringLocation
国家/地区
PeeringDBFacilityId
PeeringDBFacilityLink
MicrosoftIPv4Address
MicrosoftIPv6Address

请参阅 PeeringDB，验证你是否在所需的对等互连设施中。

此示例演示如何使用西雅图作为对等互连位置创建对等互连。

$exchangeLocations = Get-AzPeeringLocation -Kind Exchange
$exchangeLocation = $exchangeLocations | where {$_.PeeringLocation -eq "Seattle"}

#check the location metadata
$exchangeLocation

ExchangeName          : Columbia IX
PeeringLocation       : Seattle
Country               : US
PeeringDBFacilityId   : 99999
PeeringDBFacilityLink : https://www.peeringdb.com/ix/99999
MicrosoftIPv4Address  : 10.12.97.129
MicrosoftIPv6Address  :

ExchangeName          : Equinix Seattle
PeeringLocation       : Seattle
Country               : US
PeeringDBFacilityId   : 11
PeeringDBFacilityLink : https://www.peeringdb.com/ix/11
MicrosoftIPv4Address  : 198.32.134.152
MicrosoftIPv6Address  : 2001:504:12::15

...

创建 Exchange 对等互连

下面的示例演示如何在西雅图的 Equinix Internet Exchange 上创建 Exchange 连接。如果使用的是其他提供商和其他设置，请在发出请求时替换该信息。

使用 PowerShell cmdlet New-AzPeeringExchangeConnectionObject 创建将用于生成新的对等互连请求的 PowerShell 连接对象。

该示例说明如何创建 Exchange 连接。

$connection1 = New-AzPeeringExchangeConnectionObject `
    -PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
    -PeerSessionIPv4Address 198.32.134.22 `
    -PeerSessionIPv6Address  2001:504:12::22 `
    -MaxPrefixesAdvertisedIPv4 2000 `
    -MaxPrefixesAdvertisedIPv6 2000 `

如果在给定对等互连位置需要冗余，请创建另一个连接。

$connection2 = New-AzPeeringExchangeConnectionObject `
    -PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
    -PeerSessionIPv4Address 198.32.134.23 `
    -PeerSessionIPv6Address  2001:504:12::23 `
    -MaxPrefixesAdvertisedIPv4 2000 `
    -MaxPrefixesAdvertisedIPv6 2000 `

可使用 PowerShell cmdlet New-AzPeering 创建新的 Exchange 对等互连。

$asn = Get-AzPeerAsn
New-AzPeering `
    -Name "SeattleExchangePeering" `
    -ResourceGroupName "PeeringResourceGroup" `
    -PeerAsnResourceId $asn.Id `
    -PeeringLocation  $exchangeLocation[1].PeeringLocation `
    -ExchangeConnection $connection1[, $connection2]

此示例响应显示使用一个连接执行请求的时间。


Name              : SeattleExchangePeering
Sku.Name          : Basic_Exchange_Free
Kind              : Exchange
Connections       : {11}
PeerAsn.Id        : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{peerAsnName}
PeeringLocation   : Seattle
ProvisioningState : Succeeded
Location          : West US 2
Id                : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleExchangePeering
Type              : Microsoft.Peering/peerings
Tags              : {}

重要

Microsoft 开始预配请求的对等互连，ConnectionState 反映进度。有关预配相关步骤的详细信息，请参阅 Exchange 对等互连演练。

可以按如下所示检查连接状态。


$peering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"
$peering.Connections

PeeringDBFacilityId         : 11
PeerSessionIPv4Address      : 198.32.134.22
PeerSessionIPv6Address      : 2001:504:12::22
SessionStateV4              : PendingAdd
SessionStateV6              : PendingAdd
MaxPrefixesAdvertisedV4     : 2000
MaxPrefixesAdvertisedV6     : 2000
MicrosoftSessionIPv4Address : 198.32.134.152
MicrosoftSessionIPv4Address : 2001:504:12::15
Md5AuthenticationKey        :

获取 Exchange 对等互连

若要获取对等互连的列表，请运行 Get-AzPeering 命令。

Get-AzPeering ResourceGroupName "PeeringResourceGroup" -Name "SeattleExchangePeering"

此示例响应显示成功完成端到端预配的时间。

    Name                     : SeattleExchangePeering
    Sku                      : Basic_Exchange_Free
    Kind                     : Exchange
    PeeringLocation          : Seattle
    ProvisioningState        : Succeeded
    PeerAsn                  : 65000
    Connection               : ------------------------
    PeerSessionIPv4Address   : 10.21.31.100
    MicrosoftIPv4Address     : 10.21.31.50
    SessionStateV4           : Established
    MaxPrefixesAdvertisedV4  : 20000
    PeerSessionIPv6Address   : fe01::3e:100
    MicrosoftIPv6Address     : fe01::3e:50
    SessionStateV6           : Established
    MaxPrefixesAdvertisedV6  : 2000
    ConnectionState          : Active
    Connection               : ------------------------
    PeerSessionIPv4Address   : 10.21.31.101
    MicrosoftIPv4Address     : 10.21.31.51
    SessionStateV4           : Established
    MaxPrefixesAdvertisedV4  : 20000
    PeerSessionIPv6Address   : fe01::3e:101
    MicrosoftIPv6Address     : fe01::3e:51
    SessionStateV6           : Established
    MaxPrefixesAdvertisedV6  : 2000
    ConnectionState          : Active

修改 Exchange 对等互连

Exchange 对等互连支持以下修改操作：

添加 Exchange 对等互连连接。
删除 Exchange 对等互连连接。
在活动连接上添加 IPv4 或 IPv6 会话。
删除活动连接上的 IPv4 或 IPv6 会话。

添加 Exchange 对等互连连接

此示例说明如何将连接添加到现有 Exchange 对等互连。


$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"

$connection = New-AzPeeringExchangeConnectionObject `
    -PeeringDBFacilityId $exchangeLocation[1].PeeringDBFacilityId `
    -PeerSessionIPv4Address 198.32.134.22 `
    -PeerSessionIPv6Address  2001:504:12::22 `
    -MaxPrefixesAdvertisedIPv4 2000 `
    -MaxPrefixesAdvertisedIPv6 2000 `

$exchangePeering.Connections.Add($connection)

$exchangePeering | Update-AzPeering

删除 Exchange 对等互连连接

此示例说明如何删除与现有 Exchange 对等互连的连接。


$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"

查看所有连接，并选择要删除的连接。


$exchangePeering

Name              : SeattleExchangePeering
Sku.Name          : Basic_Exchange_Free
Kind              : Exchange
Connections       : {11}
PeerAsn.Id        : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{peerAsnName}
PeeringLocation   : Seattle
ProvisioningState : Succeeded
Location          : West US 2
Id                : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleExchangePeering
Type              : Microsoft.Peering/peerings
Tags              : {}

在下面的命令中，输入要删除的连接的索引号，而不是 0。


$connection = $exchangePeering.Connections[0]

$exchangePeering.Connections.Remove($connection)

$exchangePeering | Update-AzPeering

在活动连接上添加 IPv4 或 IPv6 会话

此示例说明如何将 IPv6 会话添加到现有 Exchange 连接。


$exchangePeering = Get-AzPeering -Name "SeattleExchangePeering" -ResourceGroupName "PeeringResourceGroup"

$exchangePeering.Connections[0].BgpSession.PeerSessionIPv6Address = "2001:504:12::34"

$exchangePeering | Update-AzPeering

删除活动连接上的 IPv4 或 IPv6 会话

PowerShell 当前不支持从现有连接中删除 IPv4 或 IPv6 会话。有关详细信息，请联系 Microsoft 对等互连团队。

取消预配 Exchange 对等互连

目前，不支持使用 Azure 门户或 PowerShell 取消设置。若要取消设置，请联系 Microsoft 对等互连。

其他资源

可以通过运行以下命令获取所有这些参数的详细说明：

Get-Help Get-AzPeering -detailed

后续步骤

使用 PowerShell 创建或修改直接对等互连。
使用 PowerShell 将旧版直接对等互连转换为 Azure 资源。
Internet 对等互连常见问题（常见问题解答）。

通过

使用 PowerShell 创建或修改 Exchange 对等互连

开始之前

使用 Azure PowerShell

创建和预配 Exchange 对等互连

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

获取 Exchange 对等互连支持的对等互连位置的列表

创建 Exchange 对等互连

获取 Exchange 对等互连

修改 Exchange 对等互连

添加 Exchange 对等互连连接

删除 Exchange 对等互连连接

在活动连接上添加 IPv4 或 IPv6 会话

删除活动连接上的 IPv4 或 IPv6 会话

取消预配 Exchange 对等互连

其他资源

后续步骤

其他资源