PowerShell を使用して、 Direct ピアリングを作成または変更する

[アーティクル]
11/15/2023

この記事では、PowerShell コマンドレットと Azure Resource Manager デプロイモデルを使用して、Microsoft Direct ピアリングを作成する方法について説明します。またこの記事では、リソースの状態確認、更新、削除およびプロビジョニング解除の方法も紹介します。

必要に応じて、Azure portal を使用してこのガイドを完了することもできます。

開始する前に

構成を開始する前に、前提条件と Direct ピアリングのチュートリアルを確認します。
Microsoft との Direct ピアリング接続が既にあり、Azure リソースに変換されていない場合は、「PowerShell を使用してレガシの Direct ピアリングを Azure リソースに変換する」を参照してください。

Azure PowerShell を使用する

コマンドレットを実行するには、無料のインタラクティブシェルである Azure Cloud Shell を使用できます。一般的な Azure ツールが事前にインストールされており、アカウントで使用できるように構成されています。 [コピー] を選択してコードをコピーし、Cloud Shell に貼り付けます。次に、Enter キーを選択して、それを実行します。 Cloud Shell を起動するには、次のようにいくつかの方法があります。

起動方法	スクリーンショット
ブラウザーで Cloud Shell を開きます。
Azure portal の右上にあるツールバーの [Cloud Shell] ボタンをクリックします。

Azure Cloud Shell を使用しない場合は、代わりにローカルに PowerShell をインストールできます。 PowerShell をローカルにインストールして使用する場合は、必ず Azure Resource Manager PowerShell コマンドレットの最新版をインストールしてください。 PowerShell コマンドレットは、頻繁に更新されます。最新の機能を利用するには、通常、PowerShell コマンドレットを更新する必要があります。そうでない場合は、問題が発生する可能性があります。

ローカルで実行されている PowerShell のバージョンを確認するには、'Get-Module -ListAvailable Az' コマンドレットを使用します。更新するには、「Install the Azure PowerShell module (Azure PowerShell モジュールのインストール)」を参照してください。詳細については、Azure PowerShell のインストールと構成の方法に関するページを参照してください。

macOS で PowerShell を使用する場合は、「macOS への PowerShell のインストール」の手順に従ってください。

Direct ピアリングを作成およびプロビジョニングする

構成を開始する前に、必要なモジュールをインストールしてインポートします。 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 の関連付けに関するページの手順に従ってください。この操作はピアリングを要求するために必要です。

Note

リソースグループの場所は、ピアリングを設定するために選択する場所とは関係ありません。

Direct ピアリングでサポートされているピアリングの場所の一覧を取得する

PowerShell コマンドレット Get-AzPeeringLocation の必須パラメーター Kind によって、ピアリングの場所の一覧が返されます。これは後述の手順で使用します。

Get-AzPeeringLocation -Kind Direct

直接ピアリングの場所には、次のフィールドが含まれます。

PeeringLocation
Country
PeeringDBFacilityId
PeeringDBFacilityLink
BandwidthOffers

PeeringDB を参照して、そこが目的のピアリングファシリティであることを検証します。

この例では、ピアリングの場所として Seattle を使用し、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}

Direct ピアリングを作成する

次の例は、シアトルで 10 Gbps Direct ピアリングを作成する方法を示しています。

新しいピアリング要求で使用される DirectConnection オブジェクトを作成するには、PowerShell コマンドレット New-AzPeeringDirectConnectionObject を使用します。

この例では、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

Note

前の例にある $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 コマンドレット 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                 : {}

この出力の {subscriptionId} の代わりに、実際のサブスクリプション ID が表示されることに注意してください。

Direct ピアリングを確認する

ピアリングの一覧を取得するには、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 ピアリングで次の変更操作を実行する方法について説明します。

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 ピアリングにお問い合わせください。

アクティブな接続で帯域幅をアップグレードまたはダウングレードする

この例では、既存の直接接続に 10Gbps を追加する方法について説明します。


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

アクティブな接続で IPv4 または IPv6 セッションを追加する

この例では、IPv4 セッションのみがある既存の直接接続で 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 ピアリングにお問い合わせください。

Direct ピアリングをプロビジョニング解除する

現在、Azure portal または PowerShell を使ったプロビジョニング解除はサポートされていません。プロビジョニングを解除するには、Microsoft ピアリングにお問い合わせください。

その他のリソース

次のコマンドを実行することで、すべてのパラメーターの詳細な説明を取得できます。

Get-Help Get-AzPeering -detailed

次の方法で共有

PowerShell を使用して、 Direct ピアリングを作成または変更する

開始する前に

Azure PowerShell を使用する

Direct ピアリングを作成およびプロビジョニングする

Direct ピアリングでサポートされているピアリングの場所の一覧を取得する

Direct ピアリングを作成する

Direct ピアリングを確認する

Direct ピアリングを変更する

Direct ピアリング接続を追加する

Direct ピアリング接続を削除する

アクティブな接続で帯域幅をアップグレードまたはダウングレードする

アクティブな接続で IPv4 または IPv6 セッションを追加する

アクティブな接続で IPv4 または IPv6 セッションを削除する

Direct ピアリングをプロビジョニング解除する

その他のリソース

次のステップ

フィードバック

その他のリソース

次の方法で共有

PowerShell を使用して、 Direct ピアリングを作成または変更する

開始する前に

Azure PowerShell を使用する

Direct ピアリングを作成およびプロビジョニングする

Azure アカウントにサインインしてサブスクリプションを選択する

Direct ピアリングでサポートされているピアリングの場所の一覧を取得する

Direct ピアリングを作成する

Direct ピアリングを確認する

Direct ピアリングを変更する

Direct ピアリング接続を追加する

Direct ピアリング接続を削除する

アクティブな接続で帯域幅をアップグレードまたはダウングレードする

アクティブな接続で IPv4 または IPv6 セッションを追加する

アクティブな接続で IPv4 または IPv6 セッションを削除する

Direct ピアリングをプロビジョニング解除する

その他のリソース

次のステップ

フィードバック

その他のリソース