Add-AzExpressRouteCircuitAuthorization

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

ExpressRoute 回線の承認を追加します。

構文

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

説明

Add-AzExpressRouteCircuitAuthorization コマンドレットは、ExpressRoute 回線に承認を追加します。 ExpressRoute 回線は、パブリック インターネットではなく接続プロバイダーを使用して、オンプレミス ネットワークを Microsoft クラウドに接続します。 ExpressRoute 回線の所有者は、回線ごとに 10 個もの承認を作成できます。これらの承認は、仮想ネットワーク所有者が自分のネットワークを回線に接続するために使用できる承認キーを生成します (仮想ネットワークごとに 1 つの承認)。 Add-AzExpressRouteCircuitAuthorization は、回線に新しい承認を追加すると同時に、対応する承認キーを生成します。 これらのキーは、Get-AzExpressRouteCircuitAuthorization コマンドレットを実行することでいつでも表示でき、必要に応じてコピーして適切なネットワーク所有者に転送できます。 Add-AzExpressRouteCircuitAuthorization を実行した後、Set-AzExpressRouteCircuit コマンドレットを呼び出してキーをアクティブ化する必要があることに注意してください。 Set-AzExpressRouteCircuit を呼び出さない場合、承認は回線に追加されますが、使用は有効になりません。

例

例 1: 指定された ExpressRoute 回線に承認を追加する

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

この例のコマンドは、既存の ExpressRoute 回線に新しい承認を追加します。 最初のコマンドでは、Get-AzExpressRouteCircuit を使用 して、ContosoCircuit という名前の回線へのオブジェクト参照を作成します。 そのオブジェクト参照は、$Circuitという名前の変数に格納されます。 2 番目のコマンドでは、 Add-AzExpressRouteCircuitAuthorization コマンドレットを使用して、ExpressRoute 回線に新しい承認 (ContosoCircuitAuthorization) を追加します。 このコマンドは承認を追加しますが、その承認はアクティブ化しません。 承認をアクティブ化するには、例の 最後のコマンドに示されている Set-AzExpressRouteCircuit が必要です。

パラメーター

-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

追加する回線承認の名前を指定します。

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

入力

PSExpressRouteCircuit

出力

PSExpressRouteCircuit