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 オブジェクトを返します。