次の方法で共有

Get-AzureRmExpressRouteCircuitAuthorization

  • リファレンス
モジュール:
AzureRM.Network

ExpressRoute 回線の承認に関する情報を取得します。

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Get-AzureRmExpressRouteCircuitAuthorization
   [-Name <String>]
   -ExpressRouteCircuit <PSExpressRouteCircuit>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

説明

Get-AzureRmExpressRouteCircuitAuthorization コマンドレットは、ExpressRoute 回線に割り当てられた承認に関する情報を取得します。 ExpressRoute 回線は、パブリック インターネットではなく接続プロバイダーを使用して、オンプレミス ネットワークを Microsoft クラウドに接続します。 ExpressRoute 回線の所有者は、回線ごとに 10 個もの承認を作成できます。これらの承認は、仮想ネットワーク所有者が自分のネットワークを回線に接続するために使用できる承認キーを生成します (仮想ネットワークごとに 1 つの承認)。 承認キーと承認に関するその他の情報は、Get-AzureRmExpressRouteCircuitAuthorization を実行することでいつでも表示できます。

例

例 1: すべての ExpressRoute 承認を取得する

$Circuit = Get-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Get-AzureRmExpressRouteCircuitAuthorization -Circuit $Circuit

これらのコマンドは、ExpressRoute 回線に関連付けられているすべての ExpressRoute 承認に関する情報を返します。 最初の コマンドでは、Get-AzureRmExpressRouteCircuit コマンドレットを使用して、ContosoCircuit という名前の回線をオブジェクト参照として作成します。そのオブジェクト参照は変数$Circuitに格納されます。 2 番目のコマンドでは、そのオブジェクト参照と Get-AzureRmExpressRouteCircuitAuthorization コマンドレットを使用して、ContosoCircuit に関連付けられている承認に関する情報を返します。

例 2: Where-Object コマンドレットを使用してすべての ExpressRoute 承認を取得する

$Circuit = Get-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
 Get-AzureRmExpressRouteCircuitAuthorization -Circuit $Circuit | Where-Object {$_.AuthorizationUseStatus -eq "Available"}

これらのコマンドは、例 1 で使用したコマンドのバリエーションを表します。 ただし、この場合は、使用できる権限 (つまり、仮想ネットワークに割り当てられていない権限) に対してのみ情報が返されます。 これを行うには、回線承認情報がコマンド 2 で返され、Where-Object コマンドレットにパイプされます。 Where-Object は、AuthorizationUseStatus プロパティが Available に設定されている承認のみを選択します。 使用できない承認のみを一覧表示するには、Where 句に次の構文を使用します。 {$_.AuthorizationUseStatus -ne "Available"}

パラメーター

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ExpressRouteCircuit

ExpressRoute 回線の承認を指定します。

型:PSExpressRouteCircuit
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

このコマンドレットが取得する ExpressRoute 回線承認の名前を指定します。 -Name "ContosoCircuitAuthorization"

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

PSExpressRouteCircuit

パラメーター: ExpressRouteCircuit (ByValue)

出力

PSExpressRouteCircuitAuthorization