Get-AzExpressRouteCircuitAuthorization

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

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

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

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

$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"}

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。