使用 PowerShell 建立或修改 Exchange 對等互連

2023-01-23

本文說明了如何使用 PowerShell cmdlet 和 Resource Manager 部署模型建立Microsoft Exchange對等連線。本文也會示範如何檢查資源的狀態、加以更新，或是加以刪除並取消佈建。

開始之前

開始設定之前，請先檢閱必要條件和 Exchange 對等互連導覽。
如果您已經有未轉換成 Azure 資源的 Microsoft Exchange 對等互連，請參閱使用 PowerShell 將舊版 Exchange 對等互連轉換成 Azure 資源。

使用 Azure PowerShell

若要執行 Cmdlet，您可以使用 Azure Cloud Shell，一個免費的互動式命令殼。它具有預先安裝和設定的共用 Azure 工具，可與您的帳戶搭配使用。請選取 [複製] 以複製該程式碼，並將其貼到 Cloud Shell。然後選取 Enter 以執行它。以下有幾種 Cloud Shell 的啟動方式：

啟動方法	螢幕截圖
在您的瀏覽器中開啟 Cloud Shell。
請選取 Azure 入口網站右上方工具列的 [Cloud Shell] 按鈕。

如果您不想使用 Azure Cloud Shell，您可改為在本機安裝 PowerShell。如果您選擇在本機安裝及使用 PowerShell，請務必安裝最新版的 Azure Resource Manager 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 互連位置包含下列欄位：

交易所名稱
PeeringLocation
國家
PeeringDB設施識別碼 (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 Peering。

取消佈建 Exchange 對等互連

目前不支援透過 Azure 入口網站或 PowerShell 解除佈建。若要解除布建，請聯絡 Microsoft Peering。

其他資源

您可以執行下列命令來取得所有參數的詳細描述：

Get-Help Get-AzPeering -detailed

共用方式為

使用 PowerShell 建立或修改 Exchange 對等互連

開始之前

使用 Azure PowerShell

建立及配置 Exchange 對等互連

登入您的 Azure 帳戶並且選取您的訂用帳戶

取得 Exchange 對等連接支援的位置列表

建立 Exchange 配對

取得 Exchange 對等互連

修改「Exchange」對等互聯

新增 Exchange 對等互連連線

移除 Exchange 對等連線

在活動中連線上新增 IPv4 或 IPv6 連線

在活動連線上移除 IPv4 或 IPv6 連線

取消佈建 Exchange 對等互連

其他資源

後續步驟

其他資源