Set-SCVMHostNetworkAdapter
VMM によって管理されるホスト上の物理ネットワーク アダプターのネットワーク関連プロパティを変更します。
構文
Set-SCVMHostNetworkAdapter
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-Description <String>]
[-VLanMode <VlanMode>]
[-AvailableForPlacement <Boolean>]
[-UsedForManagement <Boolean>]
[-SubnetVLan <SubnetVLan[]>]
[-RemoveUnassignedVLan <UInt16[]>]
[-AddOrSetLogicalNetwork <LogicalNetwork>]
[-RemoveLogicalNetwork <LogicalNetwork>]
[-EnableNetworkVirtualization <Boolean>]
[-UplinkPortProfileSet <UplinkPortProfileSet>]
[-RemoveUplinkPortProfileSet]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Set-SCVMHostNetworkAdapter
[-VMHostNetworkAdapter] <HostNetworkAdapter>
[-Description <String>]
[-VLanEnabled <Boolean>]
[-VLanMode <VlanMode>]
[-VLanID <UInt16>]
[-VLanTrunkID <UInt16[]>]
[-AvailableForPlacement <Boolean>]
[-UsedForManagement <Boolean>]
[-RemoveUnassignedVLan <UInt16[]>]
[-EnableNetworkVirtualization <Boolean>]
[-UplinkPortProfileSet <UplinkPortProfileSet>]
[-RemoveUplinkPortProfileSet]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] 説明
Set-SCVMHostNetworkAdapter コマンドレットは、Virtual Machine Manager (VMM) によって管理されるホスト上の物理ネットワーク アダプターのネットワーク関連のプロパティを変更します。
このコマンドレットで変更できるプロパティは次のとおりです。
- VLAN 設定: VLAN パラメーターを使用して、単一の VLAN または複数の VLAN を作成または変更できます。 VLAN 設定を指定する方法の図については、例を参照してください。
VLAN の詳細と VLAN 設定を示すその他の例については、「Get-Help Add-SCVMHostNetworkAdapter -Detailed」と入力します。
例
例 1: ホスト ネットワーク アダプターに新しい仮想ネットワークを作成し、仮想ネットワークの VLAN ID を指定する
PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost02.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost | where {$_.Name -like "Intel(R) PRO/1000*" }
PS C:\> New-SCVirtualNetwork -Name "VirtualNetwork01" -VMHost $VMHost -VMHostNetworkAdapter $HostAdapter
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $HostAdapter -VLanEnabled $True -VLanMode "Access" -VLANID 35最初のコマンドは、VMHost02 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。
2 番目のコマンドは、VMHost02 の "Intel(R) PRO/1000 で始まる名前のホスト ネットワーク アダプター オブジェクトを取得し、$HostAdapter変数にオブジェクトを格納します。
3 番目のコマンドは、vmHost02 に VirtualNetwork01 という名前の仮想ネットワークを作成し、$HostAdapterに格納されているホスト アダプターにバインドします。
最後のコマンドは VLAN を有効にし、モードを Access に設定し (1 つの VLAN 内でトラフィックを内部的にルーティングします)、ネットワーク アダプターに 35 の VLANID を割り当てます。
注: この例では、ホストが既に VLAN に接続されていること、または接続されていない場合は、ホストに 2 つのネットワーク アダプターがあることを前提としています。 ホストに 1 つのネットワーク アダプターがある場合、VMM サーバーで使用できない VLAN にアダプターを割り当てると、VMM がホストを管理できなくなります。
例 2: トランク モードで構成されたホスト ネットワーク アダプターに VLan タグを追加する
PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost03.Contoso.com"
PS C:\> $VMHostNIC = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "Adapter #3"
PS C:\> $NewVlanTags = $VMHostNIC.VlanTags + @(177,355,1012)
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $VMHostNIC -VLANEnabled $TRUE -VLanMode "Trunk" -VLanTrunkID $NewVLanTags最初のコマンドは、VMHost03 という名前のホスト オブジェクトを取得し、そのオブジェクトを $VMHost 変数に格納します。
2 番目のコマンドは、アダプター名を指定してホスト ネットワーク アダプター オブジェクトを取得し、$VMHostNIC変数にオブジェクトを格納します。
3 番目のコマンドでは、ホスト ネットワーク アダプター オブジェクト ($VMHostNIC.VlanTags) の VlanTags プロパティを使用し、タグの新しい配列を連結します。 更新された配列は、既存の VlanTag を保持し、リストされているタグを配列に追加します。 連結の結果は、$NewVlanTagsに格納されます。
最後のコマンドは、Set-VMHostNetworkAdapterの VLANTrunkID パラメーターに VLAN タグの新しいリストを渡します。 VLANMode パラメーターは、VLANTrunkID パラメーターを使用して VLAN トランクの数値識別子の一覧を変更するたびに、値 "Trunk" を指定する必要があります。
パラメーター
-AddOrSetLogicalNetwork
追加または更新される論理ネットワークを指定します。
| 型: | LogicalNetwork |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AvailableForPlacement
VMM 配置プロセスで、このホストまたはホスト上のこのボリュームが、仮想マシンを展開する可能性のある場所として適格であると見なすかどうかを示します。 このパラメーターが $False に設定されている場合は、このホストまたはボリュームに仮想マシンをデプロイすることを選択できます。 既定値は $True です。 このパラメーターは、VMware ESX ホストには適用されません。
このパラメーターをネットワーク アダプターと共に使用する場合、$Falseに設定されている場合、配置では、ホストが仮想マシンの接続に適しているかどうかを判断するために、このネットワーク アダプターで構成された論理ネットワークは考慮されません。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
指定したオブジェクトの説明を示します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnableNetworkVirtualization
ネットワーク仮想化を有効にするかどうかを指定します。 既定値は $False です。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobGroup
同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RemoveLogicalNetwork
削除する論理ネットワークを指定します。
| 型: | LogicalNetwork |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RemoveUnassignedVLan
指定された VLAN が論理ネットワークに関連付けられていない場合、指定した VLAN がアダプターの VLAN トランクから削除されるように指定します。
| 型: | UInt16[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RemoveUplinkPortProfileSet
ホスト ネットワーク アダプターからアップリンク ポート プロファイル セットを削除します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SubnetVLan
1 つ以上の IP サブネットと VLAN セットを指定します。
SubnetVLan の作成の詳細については、「Get-Help New-SCSubNetVLan」と入力します。
| 型: | SubnetVLan[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UplinkPortProfileSet
アップリンク ポート プロファイル セット オブジェクトを指定します。
アップリンク ポート プロファイル セット オブジェクトを取得するには、Get-SCUplinkPortProfileSet コマンドレットを使用します。
| 型: | UplinkPortProfileSet |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UsedForManagement
オブジェクトがホストの管理に使用されるかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VLanEnabled
Hyper-V または Citrix XenServer ホスト上の仮想マシンで使用する仮想 LAN (VLAN) を有効にします。
- 単一 VLAN のフォーマット例:
-VLANEnabled -VLANMode "Access" -VLANID 35 - 複数の VLAN の形式の例:
-VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VLanID
1 から 4094 の範囲の数値識別子を、仮想マシン上の仮想ネットワーク アダプターまたは仮想マシン ホスト上の物理ネットワーク アダプターに割り当てます。
Hyper-V、VMware ESX、または Citrix XenServer ホストで VLanID を構成します。
- VLan モードが Access の場合、外部にバインドされた物理ネットワーク アダプター。
仮想マシンの仮想ネットワーク アダプターに VLanID を構成します。
- ホスト上の物理ネットワーク アダプターにバインドされているか、または
- ホスト上の内部仮想ネットワークにバインドされます。
形式の例: -VLanEnabled -VLanMode "Access" -VLANID 35
| 型: | UInt16 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VLanMode
仮想マシン ホスト上の仮想 LAN (VLAN) が、1 つの VLAN (アクセス モード) または複数の VLAN (トランク モード) を介したトラフィックをサポートするかどうかを指定します。 有効な値は Access、Trunk です。
| 型: | VlanMode |
| 指定可能な値: | Access, Trunk, Invalid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VLanTrunkID
1 から 4094 の範囲の数値識別子の一覧を、Hyper-V ホスト上の物理ネットワーク アダプターに割り当てます。
形式の例: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
| 型: | UInt16[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMHostNetworkAdapter
そのホストにデプロイされた仮想マシンが接続できるホスト上の物理ネットワーク アダプター オブジェクトを指定します。
形式の例: -VMHostNetworkAdapter $VMHostNIC
| 型: | HostNetworkAdapter |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
VMHostNetworkAdapter
このコマンドレットは、VMHostNetworkAdapter オブジェクトを返します。