Azure ExpressRoute 関連の PowerShell コマンドレット (Get-AzureDedicatedCircuitLink) について

スポンサーリンク

Azure ExpressRoute は、Azure データセンターとインフラストラクチャ間でのプライベート (閉域網) 接続を提供します。

Azure ExpressRoute における設定について、API および PowerShell コマンドレットが提供され、接続方法についても MSDN サイト上で情報が提供されていますが、PowerShell コマンドレットのヘルプについては英語のみであり、日本語による情報はほとんど公開されていません。

Azure ExpressRoute による Azure とのハイブリッド クラウド環境や今後 Azure ExpressRoute と Office 365 とのサポートが予定 (Microsoft の発表内容参照) されていることから日本国内での利用が増えると予測されるため、Azure ExpressRoute 関連の PowerShell コマンドレットの 1 つである「Get-AzureDedicatedCircuitLink」について、日本語の情報として纏めてみました ((他の PowerShell コマンドレットについては、「Azure ExpressRoute 関連の PowerShell コマンドレットについて」を参照) (Windows Azure PowerShell バージョン 0.9.4 で確認しているものとなります)。

■名前

Get-AzureDedicatedCircuitLink

■概要

特定の仮想ネットワークおよび ExpressRoute 回線のリンク状態について一覧表示します。仮想ネットワーク名が指定されていない場合、特定の ExpressRoute 回線にリンクされたすべての仮想ネットワークについて一覧表示します。

■構文

Get-AzureDedicatedCircuitLink -ServiceKey <String> [-VNetName <String>] [<CommonParameters>]

■説明

Get-AzureDedicatedCircuitLink コマンドレットは、特定の ExpressRoute 回線に接続されたすべての仮想ネットワークに関する情報を取得します。これは、仮想ネットワーク名が提供されている場合に特定の仮想ネットワークおよび ExpressRoute 回線のリンク状態を持つオブジェクトを返し、仮想ネットワーク名が指定されていない場合は、指定したサービス キーによって識別された特定の ExpressRoute 回線にリンクされたすべての仮想ネットワークの一覧を表示します。

■パラメーター

-ServiceKey <String>
リンク情報を取得するために ExpressRoute 回線のサービス キーを取得します。これはパラメーターを要求します。

必須true
位置named
既定値none
パイプライン入力を許可するtrue (ByPropertyName)
ワイルドカード文字を許可するfalse

-VNetName <String>
リンク状態を検証する必要のある仮想ネットワーク名を指定します。

必須false
位置named
既定値none
パイプライン入力を許可するtrue (ByPropertyName)
ワイルドカード文字を許可するfalse

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: –Verbose、-Debug、-ErrorAction-ErrorVariable、-WarningAction、-WarningVariable、-OutBuffer、-PipelineVariable、および -OutVariable。詳細については、about_CommonParameters を参照してください。

■入力

■出力

  • ManagementOperationContext

■メモ

  • 詳細については、「Get-Help Get-AzureDedicatedCircuitLink -detailed」と入力してください。
  • 技術情報については、「Get-Help Get-AzureDedicatedCircuitLink -full」と入力してください。

■エイリアス

  • なし

■備考

  • なし

■例

例 1:

 Get-AzureDedicatedCircuitLink -ServiceKey "12345678-1234-1234-abcd-1234567890ab" -VNetName "MyVNet" 

このコマンドは、サービス キー “12345678-1234-1234-abcd-1234567890ab” および仮想ネットワーク “MyVNet” を持つ ExpressRoute 回線のリンク状態を表示します。

例 2:

 Get-AzureDedicatedCircuit -ServiceKey "12345678-1234-1234-abcd-1234567890ab" 

このコマンドは、サービス キー “12345678-1234-1234-abcd-1234567890ab” を持つ回線にリンクされたすべての仮想ネットワークの一覧を表示します。

■関連するトピック

  • Get-AzureBGPPeering
  • Get-AzureDedicatedCircuit
  • Get-AzureDedicatedCircuitServiceProvider
  • New-AzureBGPPeering
  • New-AzureDedicatedCircuit
  • New-AzureDedicatedCircuitLink
  • Remove-AzureBGPPeerin
  • Remove-AzureDedicatedCircuit
  • Remove-AzureDedicatedCircuitLink
  • Set-AzureBGPPeering

[参考]