New-SCVirtualNetworkAdapter

モジュール:

VirtualMachineManager

VMM で使用される仮想マシン、仮想マシン テンプレート、またはハードウェア プロファイルに仮想ネットワーク アダプターを作成します。

構文

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -VM <VM>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMHost <Host>]
   [-LogicalSwitch <LogicalSwitch>]
   -JobGroup <Guid>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -VMTemplate <Template>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -HardwareProfile <HardwareProfile>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-IPv4AddressPool <StaticIPAddressPool>]
   [-IPv6AddressPool <StaticIPAddressPool>]
   [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
   -VMHost <Host>
   -LogicalSwitch <LogicalSwitch>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

New-SCVirtualNetworkAdapter コマンドレットは、仮想マシン、仮想マシン テンプレート、または仮想マシン マネージャー (VMM) によって管理される仮想マシンの作成に使用されるハードウェア プロファイルに仮想ネットワーク アダプターを作成します。

ネットワークの場所

New-SCVirtualNetworkAdapter コマンドレットを使用して、ネットワークの場所を指定し、アダプターの作成時にホストで構成された仮想ネットワークに仮想ネットワーク アダプターを接続するか、Set-SCVirtualNetworkAdapter コマンドレットを使用して後でこれらの設定やその他の設定を構成できます。

静的または動的 MAC アドレス

仮想ネットワーク アダプターで静的 MAC アドレスと動的 MAC アドレスのどちらを使用するかを指定できます。また、静的 MAC アドレスを指定することもできます。

エミュレートされたアダプターまたは合成Virtual Network アダプター

New-SCVirtualNetworkAdapter コマンドレットを使用して、型がエミュレートされたアダプター (既定値) または合成アダプターを作成できます。

任意の種類のホスト (Hyper-V、VMware、または XenServer) 上の仮想マシンの場合は、特定の物理ネットワーク アダプターをエミュレートする仮想マシン上で仮想ネットワーク アダプターを構成できます。

Hyper-V ホスト上の仮想マシンの場合、仮想マシンにインストールされているゲスト オペレーティング システムが仮想化対応のオペレーティング システム (Windows Server 2008 や Windows Server 2016、Linux の一部のバージョンなど) である場合、VMM では、ホスト上の物理ハードウェアと通信するように仮想マシン上で高パフォーマンスの合成仮想ネットワーク アダプターを構成できます。 仮想ネットワーク アダプターが合成であることを明示的に指定するには、 Synthetic パラメーターを使用する必要があります。

仮想ローカル エリア ネットワーク

VMM には、そのホストに展開された仮想マシンで使用するために、ホスト上に 1 つ以上の仮想エリア ネットワーク (VLAN) を構成するためのサポートが含まれています。 New-SCVirtualNetworkAdapter コマンドレット (または Set-SCVirtualNetworkAdapter コマンドレット) を VLAN パラメーターと共に使用して、仮想マシン上の仮想ネットワーク アダプターを VLAN に接続できます。 ホスト ネットワーク アダプターで対応する VLAN 設定を構成するには、 Add-SCVMHostNetworkAdapter コマンドレットまたは Set-SCVMHostNetworkAdapter コマンドレットを使用します。

VLAN を構成する方法の図については、このコマンドレットの例を参照し、 New-SCVMHostNetworkAdapterConfig と Set-SCVMHostNetworkAdapter の例を参照してください。

注意

• 新しいパラメーター [-PhysicalNetworkAdapterName] が VMM 2019 UR2 以降に含まれています。 詳しくは、「パラメーター」をご覧ください。
• VMM 2019 UR3 以降には、新しいパラメーター [-AllowedVLanList] と [-NativeVLanId] が含まれています。 詳しくは、「パラメーター」をご覧ください。

例

例 1: 仮想マシンに仮想ネットワーク アダプターを作成する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VM

最初のコマンドは、VM01 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 つ目のコマンドは、VM01 上に仮想ネットワーク アダプターを作成します。

例 2: 仮想マシン テンプレートに仮想ネットワーク アダプターを作成する

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualNetworkAdapter -VMTemplate $VMTemplate

最初のコマンドは、VMTemplate01 という名前の仮想マシン テンプレート オブジェクトを取得し、そのオブジェクトを $VMTemplate 変数に格納します。

2 番目のコマンドは、VMTemplate01 に仮想ネットワーク アダプターを作成します。

例 3: エミュレートされた仮想ネットワーク アダプターと合成仮想ネットワーク アダプターをハードウェア プロファイルに作成する

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualNetworkAdapter -HardwareProfile $HWProfile
PS C:\> New-SCVirtualNetworkAdapter -HardwareProfile $HWProfile -Synthetic

最初のコマンドは、VMM ライブラリから NewHWProfile01 という名前のハードウェア プロファイル オブジェクトを取得し、そのオブジェクトを $HWProfile 変数に格納します。

2 番目のコマンドは、NewHWProfile01 に仮想ネットワーク アダプター ("ネイティブ" またはエミュレートされたアダプター) を作成します。

最後のコマンドは、NewHWProfile01 に合成仮想ネットワーク アダプターを作成します。

例 4: 仮想マシンに仮想ネットワーク アダプターを作成し、一意の MAC アドレスを割り当てる

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $VNIC = New-SCVirtualNetworkAdapter -VM $VM
PS C:\> $MACPool = Get-SCMACAddressPool -Name "MAC Address Pool 01"
PS C:\> Grant-SCMACAddress -MACAddressPool $MACPool -VirtualNetworkAdapter $VNIC

最初のコマンドは、VM04 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、$VM (VM04) に格納されている仮想マシンに仮想ネットワーク アダプターを作成し、オブジェクトを $VNIC 変数に格納します。

3 番目のコマンドは、MAC アドレス プール 01 という名前の MAC アドレス プール オブジェクトを取得し、そのオブジェクトを $MACPool 変数に格納します。

最後のコマンドは、$MACPoolに格納されているアドレス プールから次に使用可能な MAC アドレスを取得し、$VNICに格納されている仮想ネットワーク アダプターに割り当てます。

例 5: 静的 MAC アドレスと特定の VLAN ID を使用して仮想ネットワーク アダプターを作成する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $LogicalNet = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> $VirtualNet = Get-SCVirtualNetwork -Name "ExternalVirtualNetwork01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VM -LogicalNetwork $LogicalNet -VirtualNetwork $VirtualNet -MACAddress "00-16-D3-CC-00-1A" -MACAddressType "Static" -VLANEnabled $True -VLANId 3

最初のコマンドは、VM05 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、LogicalNetwork01 という名前の論理ネットワーク オブジェクトを取得し、そのオブジェクトを $LogicalNet 変数に格納します。

3 番目のコマンドは、ExternalVirtualNetwork01 という名前の仮想ネットワーク オブジェクトを取得し、オブジェクトを $VirtualNet 変数に格納します。

最後のコマンドは、VM05 用の新しい仮想ネットワーク アダプターを作成し、アダプターを $LogicalNet に格納されている論理ネットワークと、$VirtualNetに格納されている仮想ネットワークに接続します。 このコマンドは、仮想ネットワーク アダプターの静的 MAC アドレスを提供し、VLAN を有効にし、VLAN ID を 3 に指定します。

注: この例では、ホストが既に VLAN に接続されていること、または接続されていない場合は、ホストに 2 つのネットワーク アダプターがあることを前提としています。 ホストに単一のネットワーク アダプターがある場合、VMM サーバーで使用できない VLAN にアダプターを割り当てると、VMM でホストを管理できなくなります。

パラメーター

-AdapterFlags

{{Fill AdapterFlags Description}}

Type:	VirtualNetworkAdapterFlags
Accepted values:	None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowedVLanList

仮想マシン ネットワーク アダプターで許可される仮想 LAN の一覧を指定します。

注意

このパラメーターは、VMM 2019 UR3 以降に適用できます。

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

-DevicePropertiesAdapterName

ネットワーク アダプターの名前を指定します。

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

-DevicePropertiesAdapterNameMode

アダプター名モードを指定します。

Type:	DevicePropertiesAdapterNameMode
Accepted values:	Disabled, VMNetwork, Custom
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableGuestIPNetworkVirtualizationUpdates

ゲストによる IP ネットワーク仮想化の更新が有効になっているかどうかを示します。

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

-EnableMACAddressSpoofing

[$True] に設定すると、MAC アドレススプーフィングが有効になります。

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

-EnableVMNetworkOptimization

$Trueに設定すると、仮想マシン ネットワークの最適化が有効になります。

この機能により、仮想マシン キュー (VMQ) または TCP Chimney オフロードをサポートするネットワーク アダプターを使用した仮想マシンのネットワーク パフォーマンスが向上します。 VMQ を使用すると、仮想ネットワーク アダプターごとに一意のネットワーク キューを作成できます。 TCP Chimney オフロードを使用すると、ネットワーク トラフィック処理をネットワーク スタックからオフロードできます。

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

-HardwareProfile

ハードウェア プロファイル オブジェクトを指定します。

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

-InheritsAddressFromPhysicalNetworkAdapter

ネットワーク アダプターが物理ネットワーク アダプターからアドレスを継承するかどうかを示します。

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

-IPv4Address

IPv4 アドレスを指定します。

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

-IPv4AddressPool

IPv4 アドレスを含む静的アドレス プールを指定します。

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

-IPv4AddressType

IPv4 アドレスの種類を指定します。 このパラメーターの有効値は、次のとおりです。

• 動的
• 静的

Type:	EthernetAddressType
Accepted values:	Dynamic, Static
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPv6Address

IPv6 アドレスを指定します。

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

-IPv6AddressPool

IPv6 アドレスを含む静的アドレス プールを指定します。

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

-IPv6AddressType

IPv6 アドレスの種類を指定します。 このパラメーターの有効値は、次のとおりです。

• 動的
• 静的

Type:	EthernetAddressType
Accepted values:	Dynamic, Static
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JobGroup

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

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

-LogicalNetwork

論理ネットワークを指定します。 論理ネットワークは、ネットワーク割り当てを整理して簡略化するために使用される IP サブネットと VLAN の名前付きグループです。

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

-MACAddress

コンピューター上の物理または仮想ネットワーク アダプターの MAC アドレス (一連の MAC アドレス) を指定します。

• 1 つの MAC アドレスの形式の例: -MACAddress "00-15-5D-B4-DC-00"
• 一連の MAC アドレスの形式の例: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"

Type:	String
Aliases:	EthernetAddress, PhysicalAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MACAddressType

仮想ネットワーク アダプターに使用する MAC アドレスの種類を指定します。 有効な値は、Static、Dynamic です。

Type:	String
Aliases:	EthernetAddressType, PhysicalAddressType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

ネットワーク オブジェクトの名前を指定します。

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

-NativeVLanId

仮想マシン ネットワーク アダプターのネイティブ仮想 LAN 識別子を指定します。

注意

このパラメーターは、VMM 2019 UR3 以降に適用できます。

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

-NetworkLocation

物理ネットワーク アダプタまたは仮想ネットワーク アダプタ用のネットワークの場所を指定するか、ホストの物理ネットワーク アダプタに対する既定のネットワークの場所を変更します。

形式の例: -NetworkLocation $NetLoc ($NetLocには Corp.Contoso.com が含まれる場合があります) -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"

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

-NetworkTag

ホスト上の特定の内部ネットワークまたは外部ネットワークに接続するように構成されている仮想ネットワーク アダプターに関連付ける単語または語句を指定します。

NetworkTag パラメーターは、同じ NetworkTag を持つすべての仮想マシンを同じネットワークのメンバーとして識別します。 VMM は、仮想マシンを展開する候補としてホストを評価するときに NeworkTag (存在する場合) を使用します。 ホストに、配置する仮想マシンと同じ NetworkTag を持つネットワーク上の仮想マシンが含まれていない場合、ホストは配置プロセスで星を 0 個受け取ります。

Type:	String
Aliases:	Tag
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoConnection

仮想ネットワーク アダプタの接続を仮想ネットワークから切断します。

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

-NoVMNetwork

仮想マシン ネットワークが指定されていないことを示します。

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

-OnBehalfOfUser

ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーの代わりに動作します。

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

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールの代わりに動作します。

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

-PhysicalNetworkAdapterName

物理ネットワーク アダプターの名前を指定します。

注意

このパラメーターは、VMM 2019 UR2 以降に適用できます。

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

-PortACL

ポート ACL オブジェクトを指定します。

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

-PortClassification

仮想ネットワーク アダプターが接続するスイッチのポート分類を指定します。

Type:	PortClassification
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
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

-Synthetic

Hyper-V ホストにデプロイされた仮想マシン上の仮想ネットワーク アダプターなどのデバイスが、高パフォーマンスの合成デバイスであることを指定します。 バーチャル マシンには仮想化対応のゲスト オペレーティング システムが必要です。

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

-VirtualNetwork

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

Type:	String
Position:	0
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 の範囲の数値識別子を、仮想マシン上の仮想ネットワーク アダプターまたは仮想マシン ホスト上の物理ネットワーク アダプターに割り当てます。

VLan モードが Access の場合、外部にバインドされた物理ネットワーク アダプター上の Hyper-V、VMware ESX、または Citrix XenServer ホストで VLanID を構成します。

ホスト上の物理ネットワーク アダプターにバインドされている仮想マシンの仮想ネットワーク アダプターで VLanID を構成するか、ホスト上の内部仮想ネットワークにバインドします。

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

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

-VM

仮想マシン オブジェクトを指定します。

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

-VMHost

仮想マシン ホスト オブジェクトを指定します。 VMM では、Hyper-V ホスト、VMware ESX ホスト、Citrix XenServer ホストがサポートされています。

各種類のホストの詳細については、 Add-SCVMHost コマンドレットに関するページを参照してください。

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

-VMMServer

VMM サーバー オブジェクトを指定します。

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

-VMNetwork

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

仮想マシン ネットワーク オブジェクトを取得するには、 Get-SCVMNetwork コマンドレットを 使用します。

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

-VMNetworkServiceSetting

仮想マシン ネットワーク サービスの設定を指定します。

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

-VMSubnet

仮想マシン サブネット オブジェクトを指定します。

VMSubnet オブジェクトを取得するには、Get-SCVMSubnet コマンドレットを使用します。

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

-VMTemplate

仮想マシンの作成に使用する VMM テンプレート オブジェクトを指定します。

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

-VMwarePortGroup

VMware ポート グループを指定します。

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

出力

VirtualNetworkAdapter

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

メモ

• それぞれ Get-SCVirtualMachine、Get-SCVMTemplate、および Get-SCHardwareProfile コマンドレットを使用して取得できる VMM 仮想マシン オブジェクト、仮想マシン テンプレート オブジェクト、またはハードウェア プロファイル オブジェクトが必要です。

関連リンク

• Get-SCHardwareProfile
• Get-SCLogicalNetwork
• Get-SCMACAddressPool
• Get-SCVirtualMachine
• Get-SCVirtualNetwork
• Get-SCVirtualNetworkAdapter
• Get-SCVMTemplate
• Grant-SCMACAddress
• Remove-SCVirtualNetworkAdapter
• Repair-SCVirtualNetworkAdapter
• Set-SCVirtualNetworkAdapter