Set-AzureRmVirtualNetworkGatewayDefaultSite
仮想ネットワーク ゲートウェイの既定のサイトを設定します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Set-AzureRmVirtualNetworkGatewayDefaultSite
-VirtualNetworkGateway <PSVirtualNetworkGateway>
-GatewayDefaultSite <PSLocalNetworkGateway>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Set-AzureRmVirtualNetworkGatewayDefaultSite コマンドレットは、強制トンネリングの既定のサイトを仮想ネットワーク ゲートウェイに割り当てます。 強制トンネリングを使用すると、Azure 仮想マシンからオンプレミス ネットワークにインターネットにバインドされたトラフィックをリダイレクトできます。これにより、解放する前にトラフィックを検査および監査できます。 強制トンネリングは、仮想プライベート ネットワーク (VPN) トンネルを使用して実行されます。このトンネルには、既定のサイト(すべての Azure インターネットにバインドされたトラフィックがリダイレクトされるローカル ゲートウェイ)が必要です。 Set-AzureRmVirtualNetworkGatewayDefaultSite は、ゲートウェイに割り当てられている既定のサイトを変更する方法を提供します。
例
例 1: 仮想ネットワーク ゲートウェイに既定のサイトを割り当てる
PS C:\>$LocalGateway = Get-AzureRmLocalNetworkGateway -Name "ContosoLocalGateway " -ResourceGroup "ContosoResourceGroup"
PS C:\> $VirtualGateway = Get-AzureRmVirtualNetworkGateway -Name "ContosoVirtualGateway"
PS C:\> Set-AzureRmVirtualNetworkGatewayDefaultSite -GatewayDefaultSite $LocalGateway -VirtualNetworkGateway $VirtualGateway
この例では、ContosoVirtualGateway という名前の仮想ネットワーク ゲートウェイに既定のサイトを割り当てます。 最初のコマンドは、ContosoLocalGateway という名前のローカル ゲートウェイへのオブジェクト参照を作成します。 $LocalGatewayという名前の変数に格納されているこのオブジェクト参照は、既定のサイトとして構成するゲートウェイを表します。 次に、2 番目のコマンドは、仮想ネットワーク ゲートウェイへのオブジェクト参照を作成し、結果を $VirtualGateway という名前の変数に格納します。 3 番目のコマンドでは、 Set-AzureRmVirtualNetworkGatewayDefaultSite コマンドレットを使用して、既定のサイトを ContosoVirtualGateway に割り当てます。
パラメーター
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-GatewayDefaultSite
指定した仮想ネットワークの既定のサイトとして割り当てられるローカル ネットワーク ゲートウェイへのオブジェクト参照を指定します。 Get-AzureRmLocalNetworkGateway コマンドレットを使用して、ローカル ゲートウェイへのオブジェクト参照を作成できます。
型: | PSLocalNetworkGateway |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-VirtualNetworkGateway
既定のサイトが割り当てられる仮想ネットワーク ゲートウェイへのオブジェクト参照を指定します。 Get-AzureRmVirtualNetworkGateway を使用しゲートウェイの名前を指定することで、仮想ネットワーク ゲートウェイへのオブジェクト参照を作成できます。 変数$VirtualGatewayは、 VirtualNetworkGateway パラメーターのパラメーター値として使用できます。
型: | PSVirtualNetworkGateway |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
入力
パラメーター: VirtualNetworkGateway (ByValue)