次の方法で共有


Set-SCVirtualNetwork

VMM によって管理されるホストで構成された仮想ネットワークのプロパティを変更します。

構文

Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   [-Name <String>]
   [-Description <String>]
   [-BoundToVMHost <Boolean>]
   [-HostBoundVLanId <UInt16>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   -LogicalSwitch <LogicalSwitch>
   [-VMHostNetworkAdapters <HostNetworkAdapter[]>]
   [-Description <String>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   -LogicalSwitch <LogicalSwitch>
   [-Description <String>]
   [-JobGroup <Guid>]
   [-ConvertToLogicalSwitch]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualNetwork
   [-ClusterVirtualNetwork] <ClusterVirtualNetwork>
   [-Name <String>]
   [-Description <String>]
   [-BoundToVMHost <Boolean>]
   [-HostBoundVLanId <UInt16>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

Set-SCVirtualNetwork コマンドレットは、Virtual Machine Manager (VMM) によって管理されるホストで構成された仮想ネットワークのプロパティを変更します。

変更できる仮想ネットワーク プロパティは次のとおりです。

  • 任意のホスト。 VMM でサポートされている任意のホスト (Hyper-V、VMware ESX、または Citrix XenServer ホスト) にデプロイされている仮想マシン用に構成された仮想ネットワークの場合は、名前または説明を設定または変更できます。

  • Hyper-V ホストのみ。 ホストが Hyper-V ホストの場合は、仮想マシンがホストにバインドされているかどうかを構成することもでき (ホスト オペレーティング システムにアクセスできます)、ホスト上の仮想ローカル エリア ネットワーク (VLAN) の数値識別子を指定することもできます。

例 1: ホストから仮想ネットワークをバインド解除する

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "InternalVNet01"
PS C:\> Set-SCVirtualNetwork -VirtualNetwork $VirtualNetwork -Name "UnboundVNet01" -BoundToVMHost $False

最初のコマンドは、VMHost01 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。

2 番目のコマンドは、VMHost01 から InternalVNet01 という名前の仮想ネットワーク オブジェクトを取得し、そのオブジェクトを $VirtualNetwork 変数に格納します。

最後のコマンドは、仮想ネットワークの名前を UnboundVNet01 に変更し、 VMHostBound を $False に設定します。 これにより仮想ネットワークとホストのバインドは解除され、この仮想ネットワークに接続している仮想マシンはこのネットワークからホストにアクセスできなくなります。

パラメーター

-BoundToVMHost

仮想ネットワークがホストにバインドされているかどうかを示します。 仮想ネットワークをホストにバインドすると、ホストとのネットワーク通信が可能になります。

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

-ClusterVirtualNetwork

クラスター仮想ネットワーク オブジェクトを指定します。

Type:ClusterVirtualNetwork
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ConvertToLogicalSwitch

このコマンドレットが仮想ネットワークを論理スイッチに変換することを示します。

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

-HostBoundVLanId

指定した仮想ネットワークのホスト用に作成された仮想ネットワーク アダプターに VLAN を割り当てます。

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

-JobGroup

同じジョブ グループ識別子を含む最後のコマンドが実行される直前に一括して実行される、一連のコマンドの識別子を指定します。

Type:Guid
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

-LogicalSwitch

論理スイッチ オブジェクトを指定します。

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

-Name

VMM オブジェクトの名前を指定します。

Type:String
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

-RunAsynchronously

コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。

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

-VirtualNetwork

仮想ネットワーク オブジェクトを指定します。

Type:VirtualNetwork
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHostNetworkAdapters

ホスト上にある 1 つ以上の物理ネットワーク アダプタ オブジェクトの配列を指定します。これらのオブジェクトは、そのホストに展開されるバーチャル マシンが接続できるオブジェクトです。

形式の例: -VMHostNetworkAdapters $VMHostNICs

Type:HostNetworkAdapter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

出力

VirtualNetwork

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