Add-AzExpressRouteCircuitAuthorization
ExpressRoute 回線の承認を追加します。
構文
Default (既定)
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 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExpressRouteCircuit
このコマンドレットが承認を追加する ExpressRoute 回線を指定します。
パラメーターのプロパティ
| 型: | PSExpressRouteCircuit |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
追加する回線承認の名前を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
