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

發行項
04/15/2024

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

如果您想要的話，可以使用 Azure 入口網站完成本指南。

開始之前

開始設定之前，請檢閱先決條件與 Exchange 對等互連逐步解說。
如果您已經有與 Microsoft 的 Exchange 對等互連，且該對等互連尚未轉換成 Azure 資源，請參閱使用 PowerShell 將舊版 Exchange 對等互連轉換成 Azure 資源。

使用 Azure PowerShell

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

啟動方法	Screenshot
在您的瀏覽器中開啟 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 對等互連位置包含下欄欄位：

ExchangeName
PeeringLocation
Country
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 建立或修改 Exchange 對等互連

開始之前

使用 Azure PowerShell

建立及佈建 Exchange 對等互連

取得 Exchange 對等互連支援的對等互連位置清單

建立 Exchange 對等互連

取得 Exchange 對等互連

修改 Exchange 對等互連

新增 Exchange 對等互連連線

移除 Exchange 對等互連連線

在作用中連線上新增 IPv4 或 IPv6 工作階段

在作用中連線上移除 IPv4 或 IPv6 工作階段

取消佈建 Exchange 對等互連

其他資源

下一步

意見反應

其他資源

共用方式為

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

開始之前

使用 Azure PowerShell

建立及佈建 Exchange 對等互連

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

取得 Exchange 對等互連支援的對等互連位置清單

建立 Exchange 對等互連

取得 Exchange 對等互連

修改 Exchange 對等互連

新增 Exchange 對等互連連線

移除 Exchange 對等互連連線

在作用中連線上新增 IPv4 或 IPv6 工作階段

在作用中連線上移除 IPv4 或 IPv6 工作階段

取消佈建 Exchange 對等互連

其他資源

下一步

意見反應

其他資源