Add-SCVMNetworkGateway
VMM に仮想マシン ネットワーク ゲートウェイを追加します。
構文
Add-SCVMNetworkGateway
[-VMMServer <ServerConnection>]
-VMNetwork <VMNetwork>
[-RequiresVPN]
[-RequiresNAT]
[-EnableBGP <Boolean>]
[-AutonomousSystemNumber <UInt32>]
-Name <String>
[-Description <String>]
[-RoutingIPSubnet <String>]
[-FabricRole <FabricRole>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Add-SCVMNetworkGateway
[-VMMServer <ServerConnection>]
-VMNetwork <VMNetwork>
-NetworkGateway <NetworkServiceBase>
[-EnableBGP <Boolean>]
[-AutonomousSystemNumber <UInt32>]
-Name <String>
[-Description <String>]
[-RoutingIPSubnet <String>]
[-FabricRole <FabricRole>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] 説明
Add-SCVMNetworkGateway コマンドレットは、仮想マシン ネットワーク ゲートウェイを Virtual Machine Manager (VMM) に追加します。
例
例 1: 仮想マシン ネットワーク ゲートウェイを作成する
PS C:\> $ContosoNetworkGateway = Get-SCNetworkGateway -Name "ContosoNetworkGateway"
PS C:\> $VmNetworkGateway = Add-SCVMNetworkGateway -Name "VMNetworkGateway" -EnableBGP $True -NetworkGateway $ContosoNetworkGateway -VMNetwork $VmNetwork -AutonomousSystemNumber "1000" -RoutingIPSubnet "10.251.251.0/29"最初のコマンドは、ContosoNetworkGateway という名前のネットワーク ゲートウェイを取得し、それを $ContosoNetworkGateway 変数に格納します。
2 番目のコマンドは、$ContosoNetworkGateway内のゲートウェイの仮想マシン ネットワーク ゲートウェイを作成します。
例 2: 仮想マシン ネットワーク ゲートウェイを作成する (IPv6)
注意
この例は、VMM 2019 UR2 以降から適用できます。
PS C:\> $ContosoNetworkGateway = Get-SCNetworkGateway -Name "ContosoNetworkGateway"
PS C:\> $VmNetworkGateway = Add-SCVMNetworkGateway -Name "VMNetworkGateway" -EnableBGP $True -NetworkGateway $ContosoNetworkGateway -VMNetwork $VmNetwork -AutonomousSystemNumber "1000" -RoutingIPSubnet "10.251.251.0;FD4A:293D:184F:382C::/64"最初のコマンドは、ContosoNetworkGateway という名前のネットワーク ゲートウェイを取得し、それを $ContosoNetworkGateway 変数に格納します。
2 番目のコマンドは、$ContosoNetworkGateway内のゲートウェイの仮想マシン ネットワーク ゲートウェイを作成します。
パラメーター
-AutonomousSystemNumber
自律システム番号 (ASN) を指定します。
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
仮想マシン ネットワーク ゲートウェイの説明を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableBGP
Border Gateway Protocol (BGP) が有効かどうかを示します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FabricRole
ファブリック ロールを指定します。
| Type: | FabricRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
VMM オブジェクトの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NetworkGateway
ネットワーク ゲートウェイ オブジェクトを指定します。
ネットワーク ゲートウェイ オブジェクトを取得するには、 Get-SCNetworkGateway コマンドレットを使用します。
| Type: | NetworkServiceBase |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーの代わりに動作します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールの代わりに動作します。
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiresNAT
接続にネットワーク アドレス変換 (NAT) が必要であることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiresVPN
仮想プライベート ネットワーク (VPN) が必要であることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RoutingIPSubnet
仮想マシン ネットワーク ゲートウェイのルーティング IP サブネットを指定します。
Note
2019 UR2 から、";" で区切られた IPV4 アドレスと IPV6 アドレスをこのパラメーターに渡すことができます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMNetwork
仮想マシン ネットワーク オブジェクトを指定します。
仮想マシン ネットワーク オブジェクトを取得するには、 Get-SCVMNetwork コマンドレットを 使用します。
| Type: | VMNetwork |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |