次の方法で共有

Add-AzureRmExpressRouteCircuitAuthorization

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

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

警告

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

AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

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

説明

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

例

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

$Circuit = Get-AzureRmExpressRouteCircuit -Name "ContosoCircuit" -ResourceGroupName "ContosoResourceGroup"
Add-AzureRmExpressRouteCircuitAuthorization -Name "ContosoCircuitAuthorization" -Circuit $Circuit
Set-AzureRmExpressRouteCircuit -ExpressRouteCircuit $Circuit

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

パラメーター

-DefaultProfile

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

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

-ExpressRouteCircuit

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

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

-Name

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

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

入力

PSExpressRouteCircuit

パラメーター: ExpressRouteCircuit (ByValue)

出力

PSExpressRouteCircuit