PowerShell を使用してピア ASN を Azure サブスクリプションに関連付ける
ピアリング要求を送信する前にまず、本記事の手順に従って、ASN を Azure サブスクリプションに関連付ける必要があります。
ご希望に応じて、このガイドは Azure portal を使用して完了することもできます。
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 のインストール」の手順に従ってください。
PeerASN を作成して ASN を Azure サブスクリプションに関連付ける
Azure アカウントにサインインしてサブスクリプションを選択する
構成を開始する前に、必要なモジュールをインストールしてインポートします。 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
リソース グループの場所は、ピアリングを設定するために選択する場所とは関係ありません。
ピアリング リソース プロバイダーに登録する
Register-AzResourceProvider を使用して、サブスクリプションのピアリング リソース プロバイダーに登録します。 これを実行しないと、ピアリングのセットアップに必要な Azure リソースにアクセスできません。
Register-AzResourceProvider -ProviderNamespace Microsoft.Peering
登録の状態は、Get-AzResourceProvider を使用して確認できます。
Get-AzResourceProvider -ProviderNamespace Microsoft.Peering
重要
RegistrationState が "Registered" になるまで待ってから、次に進みます。 コマンドを実行した後、5 から 30 分かかる場合があります。
このサブスクリプションに関連付けられているピア情報を更新する
New-AzPeerAsn を使用して、このサブスクリプションに関連付けられているピア情報を更新します。
$contactDetails = New-AzPeerAsnContactDetail -Role Noc -Email "noc@contoso.com" -Phone "+1 (555) 555-5555"
New-AzPeerAsn -Name "Contoso_1234" -PeerName "Contoso" -PeerAsn 1234 -ContactDetail $contactDetails
Note
-Name は、リソース名に対応し、任意の名前を選択できます。 一方、-peerName は会社の名前に対応しており、PeeringDB プロファイルにできるだけ近いものにする必要があります。 -peerName の値では、文字 a-z、A-Z、およびスペースのみがサポートされていることに注意してください。
1 つのサブスクリプションで複数の ASN を使用できます。 各 ASN のピアリング情報を更新します。 "name" が各 ASN に対して一意であることを確認します。
ピアの PeeringDB には、完全な最新のプロファイルが必要です。 登録時にこの情報を使用して、NOC 情報、技術担当者の連絡先情報、ピアリング設備での存在など、ピアの詳細が検証されます。
出力の {subscriptionId} の場所には、実際のサブスクリプション ID が表示されます。
PeerASN の状態を表示する
ASN 検証の状態を確認するには、Get-AzPeerAsn を使用します。
Get-AzPeerAsn
応答の例を以下に示します。
PeerContactInfo : Microsoft.Azure.PowerShell.Cmdlets.Peering.Models.PSContactInfo
PeerName : Contoso
ValidationState : Approved
PeerAsnProperty : 1234
Name : Contoso_1234
Id : /subscriptions/{subscriptionId}/providers/Microsoft.Peering/peerAsns/Contoso_1234
Type : Microsoft.Peering/peerAsns
重要
ValidationState が "Approved" になるのを待ってから、ピアリング要求を送信します。 この承認には、最大で 12 時間かかる場合があります。
PeerASN を変更する
NOC の連絡先情報は、Set-AzPeerAsn を使用することでいつでも変更できます。
Set-AzPeerAsn -Name Contoso_1234 -Email "newemail@test.com" -Phone "1800-000-0000"
PeerASN を削除する
現在、PeerASN の削除はサポートされていません。 PeerASN を削除する必要がある場合は、Microsoft ピアリングにお問い合わせください。