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

發行項
03/18/2024

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

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

開始之前

開始設定之前，請閱讀必要條件和直接對等互連逐步解說。
如果您已有與 Microsoft 的直接對等互連連線，且尚未轉換成 Azure 資源，請參閱使用 PowerShell 將舊版直接對等互連轉換成 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的步驟。

建立和佈建直接對等互連

開始設定之前，請先安裝並匯入必要的模組。您需要系統管理員權限，才能在 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 的關聯中的步驟。要求對等互連需要執行此動作。

注意

資源群組的位置與您選擇的對等互連設定位置無關。

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

PowerShell cmdlet Get-AzPeeringLocation 會傳回具有必要參數 Kind 的對等互連位置清單，您將在稍後的步驟中使用該參數。

Get-AzPeeringLocation -Kind Direct

Direct 對等互連位置包含下列欄位：

PeeringLocation
Country
PeeringDBFacilityId
PeeringDBFacilityLink
BandwidthOffers

藉由參考 PeeringDB，確認您是否出現在所需的對等互連設施。

此範例示範如何使用西雅圖作為對等互連位置來建立 Direct 對等互連。

$peeringLocations = Get-AzPeeringLocation -Kind Direct
$peeringLocation = $peeringLocations | where {$_.PeeringLocation -contains "Seattle"}
$peeringLocation

PeeringLocation       : Seattle
Address               : 2001 Sixth Avenue
Country               : US
PeeringDBFacilityId   : 71
PeeringDBFacilityLink : https://www.peeringdb.com/fac/71
BandwidthOffers       : {10Gbps, 100Gbps}

建立直接對等互連

下列範例示範如何在西雅圖建立 10 Gbps Direct 對等互連。

使用 PowerShell Cmdlet New-AzPeeringDirectConnectionObject 來建立要在新對等互連要求中使用的 DirectConnection 物件。

此範例顯示如何建立 DirectConnection 物件：

$connection1 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.31.0/31 `
    -SessionPrefixV6 fe01::3e:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

注意

上一個範例中 $peeringLocation[] 的值應該對應於您所選擇的對等互連位置。

如果您在指定的對等互連位置需要備援，請建立另一個連線。

$connection2 = New-AzPeeringDirectConnectionObject `
    -PeeringDBFacilityId $peeringLocation[0].PeeringDBFacilityId `
    -SessionPrefixV4 10.21.33.0/31 `
    -SessionPrefixV6 fe01::3f:0/127 `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

使用 PowerShell Cmdlet New-AzPeering 來建立新的 Direct 對等互連。此命令需要 ASN 資源 ID，它可以按此處所示來加以擷取。

$asn = Get-AzPeerAsn
New-AzPeering `
    -Name "SeattleDirectPeering" `
    -ResourceGroupName "PeeringResourceGroup" `
    -PeeringLocation  $peeringLocation[0].PeeringLocation `
    -PeerAsnResourceId $asn.Id `
    -DirectConnection $connection1 [, $connection2]

此範例顯示成功處理要求時的回應。


    Name                 : SeattleDirectPeering
    Sku.Name             : Basic_Direct_Free
    Kind                 : Direct
    Connections          : 71
    PeerAsn.Id           : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
    UseForPeeringService : False
    PeeringLocation      : Seattle
    ProvisioningState    : Succeeded
    Location             : centralus
    Id                   : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
    Type                 : Microsoft.Peering/peerings
    Tags                 : {}

請注意，將顯示實際的訂閱 ID，而不是此輸出中的 {subscriptionId}。

驗證直接對等互連

若要取得對等互連清單，請執行 Get-AzPeering 命令。

$directPeering = Get-AzPeering -ResourceGroupName "PeeringResourceGroup" -Name "SeattleDirectPeering"

下列範例顯示成功完成端對端佈建時的回應。

    Name                 : SeattleDirectPeering
    Sku.Name             : Basic_Direct_Free
    Kind                 : Direct
    Connections          : {71}
    PeerAsn.Id           : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/SeattleDirectPeering
    UseForPeeringService : False
    PeeringLocation      : Seattle
    ProvisioningState    : Succeeded
    Location             : centralus
    Id                   : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
    Type                 : Microsoft.Peering/peerings
    Tags                 : {}

修改直接對等互連

本節說明如何針對直接對等互連執行下列修改作業：

新增 Direct 對等互連連線。
移除 Direct 對等互連連線。
升級或降級作用中連線上的頻寬。
在作用中連線上新增 IPv4 或 IPv6 工作階段。
在作用中連線上移除 IPv4 或 IPv6 工作階段。

新增 Direct 對等互連連線

此範例描述如何將連線新增至現有的 Direct 對等互連。


$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"

$connection = New-AzPeeringDirectConnection `
    -PeeringDBFacilityId $peeringLocation.PeeringDBFacilityId `
    -SessionPrefixV4 "10.22.31.0/31" `
    -SessionPrefixV6 "fe02::3e:0/127" `
    -MaxPrefixesAdvertisedIPv4 1000 `
    -MaxPrefixesAdvertisedIPv6 100 `
    -BandwidthInMbps 10000

$directPeering.Connections.Add($connection)

$directPeering | Update-AzPeering

移除 Direct 對等互連連線

PowerShell 目前不支援移除連線。如需詳細資訊，請連絡 Microsoft 對等互連。

升級或降級作用中連線上的頻寬

此範例描述如何將 10 Gbps 新增至現有的 Direct 連線。


$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BandwidthInMbps  = 20000
$directPeering | Update-AzPeering

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

此範例描述如何在只有 IPv4 工作階段的現有 Direct 連線上新增 IPv6 工作階段。


$directPeering = Get-AzPeering -Name "SeattleDirectPeering" -ResourceGroupName "PeeringResourceGroup"
$directPeering.Connections[0].BGPSession.SessionPrefixv6 = "fe01::3e:0/127"
$directPeering | Update-AzPeering

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

PowerShell 上目前不支援將 IPv4 或 IPv6 工作階段從現有連線中移除。如需詳細資訊，請連絡 Microsoft 對等互連。

取消佈建直接對等互連

目前不支援使用 Azure 入口網站或 PowerShell 取消布建。如需取消佈建，請連絡 Microsoft 對等互連。

其他資源

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

Get-Help Get-AzPeering -detailed

共用方式為

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

開始之前

使用 Azure PowerShell

建立和佈建直接對等互連

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

建立直接對等互連

驗證直接對等互連

修改直接對等互連

新增 Direct 對等互連連線

移除 Direct 對等互連連線

升級或降級作用中連線上的頻寬

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

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

取消佈建直接對等互連

其他資源

下一步

意見反應

其他資源

共用方式為

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

開始之前

使用 Azure PowerShell

建立和佈建直接對等互連

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

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

建立直接對等互連

驗證直接對等互連

修改直接對等互連

新增 Direct 對等互連連線

移除 Direct 對等互連連線

升級或降級作用中連線上的頻寬

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

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

取消佈建直接對等互連

其他資源

下一步

意見反應

其他資源