New-SCDefaultGateway

  • リファレンス
モジュール:
VirtualMachineManager

静的 IP アドレス プールを作成または変更するときに使用される既定のゲートウェイ オブジェクトを作成します。

構文

New-SCDefaultGateway
   [-VMMServer <ServerConnection>]
   -IPAddress <String>
   [-Automatic]
   [<CommonParameters>]
New-SCDefaultGateway
   [-VMMServer <ServerConnection>]
   -IPAddress <String>
   -Metric <Int32>
   [<CommonParameters>]

説明

New-SCDefaultGateway コマンドレットは、静的 IP アドレス プールを作成または変更するときに使用される仮想マシン マネージャー (VMM) の既定のゲートウェイ オブジェクトを作成します。 既定のメトリックは自動です。この設定を変更するには、 Metric パラメーターを使用します。

例

例 1: 自動的に計算されるメトリックを使用して既定のゲートウェイ オブジェクトを作成する

PS C:\> $Gateway = New-SCDefaultGateway -IPAddress 10.0.0.1 -Automatic

このコマンドは、IP アドレスが 10.0.0.1 のゲートウェイ オブジェクトを作成し、ゲートウェイ オブジェクトのメトリックを自動的に計算し、そのオブジェクトを $Gateway 変数に格納します。

例 2: 既定のゲートウェイ オブジェクトを作成し、そのメトリックを手動で設定する

PS C:\> $Gateway = New-SCDefaultGateway -IPAddress 10.0.1.1 -Metric 10

このコマンドは、IP アドレスが 10.0.0.1 のゲートウェイ オブジェクトを作成し、そのメトリックを 10 に設定した後、オブジェクトを $Gateway 変数に格納します。

パラメーター

-Automatic

ネットワーク ゲートウェイに関連付けられているメトリックが自動的に計算されるかどうかを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPAddress

IPv4 または IPv6 アドレスを指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Metric

ネットワーク ゲートウェイに関連付けられている数値メトリックを指定します。

Type:Int32
Position:Named
Default value:None
Required:True
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

出力

DefaultGateway

このコマンドレットは 、DefaultGateway オブジェクトを返します。