次の方法で共有


Add-AzExpressRouteCircuitAuthorization

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 との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

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

-ExpressRouteCircuit

このコマンドレットが承認を追加する ExpressRoute 回線を指定します。

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

-Name

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

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

入力

PSExpressRouteCircuit

出力

PSExpressRouteCircuit