Get-AzExpressRouteCircuitAuthorization

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

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

構文

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

説明

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

例

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

$Circuit = Get-AzExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Get-AzExpressRouteCircuitAuthorization -ExpressRouteCircuit $Circuit

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

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

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

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

パラメーター

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExpressRouteCircuit

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

Type:PSExpressRouteCircuit
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

PSExpressRouteCircuit

出力

PSExpressRouteCircuitAuthorization