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

本文介绍如何使用 PowerShell cmdlet（命令行工具）和 Resource Manager 部署方式创建 Microsoft Exchange 对等连接。本文还介绍如何查看资源状态，以及如何更新、删除和取消预配资源。

开始之前

在开始配置之前，请查看先决条件和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 命令频繁地更新。你通常需要更新 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 对等互连位置包含以下字段：

交易所名称
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

后续步骤

Last updated on 2023-01-23

通过

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

开始之前

使用 Azure PowerShell

创建和配置 Exchange 对等连接

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

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

创建 Exchange 对等连接

获取 Exchange 对等互连

修改 Exchange 对等连接

添加 Exchange 对等连接

删除 Exchange 对等连接

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

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

取消配置 Exchange 对等互连

其他资源

后续步骤

其他资源