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 パラメータを使用して、1 つの 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に格納されます。

最後のコマンドは、VLAN タグの新しいリストを Set-VMHostNetworkAdapterVLANTrunkID パラメーターに渡します。 VLANMode パラメーターは、VLANTrunkID パラメーターを使用して VLAN トランクの数値識別子の一覧を変更するたびに、値 "Trunk" を指定する必要があります。

パラメーター

-AddOrSetLogicalNetwork

追加または更新される論理ネットワークを指定します。

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

-AvailableForPlacement

VMM 配置プロセスで、このホストまたはホスト上のこのボリュームが、仮想マシンを展開する可能性のある場所として適格であると見なすかどうかを示します。 このパラメーターが $False に設定されている場合は、このホストまたはボリュームに仮想マシンをデプロイすることを選択できます。 既定値は $True です。 このパラメーターは、VMware ESX ホストには適用されません。

このパラメーターをネットワーク アダプターと共に使用する場合、$Falseに設定されている場合、配置では、ホストが仮想マシンの接続に適しているかどうかを判断するために、このネットワーク アダプターで構成されている論理ネットワークは考慮されません。

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

-EnableNetworkVirtualization

ネットワーク仮想化を有効にするかどうかを指定します。 既定値は $False です。

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

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

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

-RemoveLogicalNetwork

削除する論理ネットワークを指定します。

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

-RemoveUnassignedVLan

指定された VLAN が論理ネットワークに関連付けられていない場合は、指定された VLAN をアダプターの VLAN トランクから削除することを指定します。

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

-RemoveUplinkPortProfileSet

ホスト ネットワーク アダプターからアップリンク ポート プロファイル セットを削除します。

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

-SubnetVLan

1 つ以上の IP サブネットと VLAN セットを指定します。

SubnetVLan の作成の詳細については、「.」と入力します Get-Help New-SCSubNetVLan

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

-UplinkPortProfileSet

アップリンク ポート プロファイル セット オブジェクトを指定します。

アップリンク ポート プロファイル セット オブジェクトを取得するには、 Get-SCUplinkPortProfileSet コマンドレットを 使用します。

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

-UsedForManagement

ホストの管理にオブジェクトを使用するかどうかを示します。

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

-VLanEnabled

Hyper-V または Citrix XenServer ホスト上の仮想マシンで使用する仮想 LAN (VLAN) を有効にします。

  • 1 つの VLAN の形式の例: -VLANEnabled -VLANMode "Access" -VLANID 35
  • 複数の VLAN の形式の例: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanID

1 から 4094 の範囲の数値識別子を、仮想マシン上の仮想ネットワーク アダプターまたは仮想マシン ホスト上の物理ネットワーク アダプターに割り当てます。

Hyper-V、VMware ESX、または Citrix XenServer ホストで VLanID を構成します。

  • VLan モードが Access の場合、外部にバインドされた物理ネットワーク アダプター。

仮想マシンの仮想ネットワーク アダプターで VLanID を構成します。

  • ホスト上の物理ネットワーク アダプターにバインドされているか、または
  • ホスト上の内部仮想ネットワークにバインドされます。

形式の例: -VLanEnabled -VLanMode "Access" -VLANID 35

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

-VLanMode

仮想マシン ホスト上の仮想 LAN (VLAN) が、1 つの VLAN (アクセス モード) または複数の VLAN (トランク モード) 間のトラフィックをサポートするかどうかを指定します。 有効な値は Access、Trunk です。

Type:VlanMode
Accepted values:Access, Trunk, Invalid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanTrunkID

Hyper-V ホスト上の物理ネットワーク アダプタに、1 ~ 4,094 の範囲の数値識別子のリストを割り当てます。

形式の例: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

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

-VMHostNetworkAdapter

そのホストにデプロイされた仮想マシンが接続できるホスト上の物理ネットワーク アダプター オブジェクトを指定します。

形式の例: -VMHostNetworkAdapter $VMHostNIC

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

出力

VMHostNetworkAdapter

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