PowerShell を使用してレガシの Direct ピアリングを Azure リソースに変換する
この記事では、PowerShell コマンドレットを使用して、既存のレガシの Direct ピアリングを Azure リソースに変換する方法について説明します。
必要に応じて、Azure portal を使用してこのガイドを完了することもできます。
開始する前に
- 構成を開始する前に、前提条件と Direct ピアリングのチュートリアルを確認します。
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 ピアリングを Azure リソースに変換する
Azure アカウントにサインインしてサブスクリプションを選択する
構成を開始する前に、必要なモジュールをインストールしてインポートします。 PowerShell でモジュールをインストールするには、管理者特権が必要です。
Az モジュールをインストールしてインポートします。
Install-Module Az -AllowClobber Import-Module AzAz.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 ピアリングを取得する
次の例は、シアトルのピアリングの場所でレガシの Direct ピアリングを取得する方法を示しています。
$legacyPeering = Get-AzLegacyPeering `
-Kind Direct -PeeringLocation "Seattle"
$legacyPeering
次は応答の例です。
Name :
Sku : Basic_Direct_Free
Kind : Direct
PeeringLocation : Seattle
UseForPeeringService : False
PeerAsn.Id :
Connection : ------------------------
PeeringDBFacilityId : 71
SessionPrefixIPv4 : 4.71.156.72/30
PeerSessionIPv4Address : 4.71.156.73
MicrosoftIPv4Address : 4.71.156.74
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
SessionPrefixIPv6 : 2001:1900:2100::1e10/126
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
BandwidthInMbps : 0
ProvisionedBandwidthInMbps : 20000
Connection : ------------------------
PeeringDBFacilityId : 71
SessionPrefixIPv4 : 4.68.70.140/30
PeerSessionIPv4Address : 4.68.70.141
MicrosoftIPv4Address : 4.68.70.142
SessionStateV4 : Established
MaxPrefixesAdvertisedV4 : 20000
SessionPrefixIPv6 : 2001:1900:4:3::cc/126
PeerSessionIPv6Address : 2001:1900:4:3::cd
MicrosoftIPv6Address : 2001:1900:4:3::ce
SessionStateV6 : Established
MaxPrefixesAdvertisedV6 : 2000
ConnectionState : Active
BandwidthInMbps : 0
ProvisionedBandwidthInMbps : 20000
ProvisioningState : Succeeded
レガシの Direct ピアリングを変換する
重要
レガシのピアリングを Azure リソースに変換する場合、変更はサポートされません。
次のコマンドを使用して、レガシの Direct ピアリングを Azure リソースに変換します。
$legacyPeering[0] | New-AzPeering `
-Name "SeattleDirectPeering" `
-ResourceGroupName "PeeringResourceGroup" `
次は応答の例です。
Name : SeattleDirectPeering
Sku.Name : Basic_Direct_Free
Kind : Direct
Connections : {11, 11}
PeerAsn.Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/{asnNumber}
UseForPeeringService : False
PeeringLocation : Seattle
ProvisioningState : Succeeded
Location : centralus
Id : /subscriptions/{subscriptionId}/resourceGroups/PeeringResourceGroup/providers/Microsoft.Peering/peerings/SeattleDirectPeering
Type : Microsoft.Peering/peerings
Tags : {}
その他のリソース
次のコマンドを実行することで、すべてのパラメーターの詳細な説明を取得できます。
Get-Help Get-AzPeering -detailed