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
パラメーター
-BoundToVMHost
仮想ネットワークがホストにバインドされているかどうかを示します。 仮想ネットワークをホストにバインドすると、ホストとのネットワーク通信が可能になります。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ClusterVirtualNetwork
クラスター仮想ネットワーク オブジェクトを指定します。
| 型: | ClusterVirtualNetwork |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ConvertToLogicalSwitch
このコマンドレットが仮想ネットワークを論理スイッチに変換することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
仮想ネットワークの説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-HostBoundVLanId
指定した仮想ネットワークのホスト用に作成された仮想ネットワーク アダプターに VLAN を割り当てます。
| 型: | UInt16 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobGroup
同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LogicalSwitch
論理スイッチ オブジェクトを指定します。
| 型: | LogicalSwitch |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
VMM オブジェクトの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VirtualNetwork
仮想ネットワーク オブジェクトを指定します。
| 型: | VirtualNetwork |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMHostNetworkAdapters
そのホストにデプロイされた仮想マシンが接続できるホスト上の 1 つ以上の物理ネットワーク アダプター オブジェクトの配列を指定します。
形式の例: -VMHostNetworkAdapters $VMHostNICs
| 型: | HostNetworkAdapter[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
VirtualNetwork
このコマンドレットは、VirtualNetwork オブジェクトを返します。