次の方法で共有


Set-SCVirtualNetworkAdapter

VMM で仮想マシンを作成するために使用する仮想マシン、仮想マシン テンプレート、またはハードウェア プロファイルに関連付けられている仮想ネットワーク アダプターのプロパティを変更します。

構文

Set-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMMServer <ServerConnection>]
   -SlotID <Int32>
   [-VirtualNetwork <String>]
   [-RequiredBandwidth <Decimal>]
   [-NoConnection]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoLogicalNetwork]
   -JobGroup <Guid>
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-NoPortClassification]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMMServer <ServerConnection>]
   [-VirtualNetworkAdapter] <VirtualNetworkAdapter>
   [-VirtualNetwork <String>]
   [-RequiredBandwidth <Decimal>]
   [-NoConnection]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoLogicalNetwork]
   [-JobGroup <Guid>]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-NoPortClassification]
   [-IPv4Addresses <System.Collections.Generic.List`1[System.String]>]
   [-IPv6Addresses <System.Collections.Generic.List`1[System.String]>]
   [-IPv4AddressPools <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]>]
   [-IPv6AddressPools <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualNetworkAdapter
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-VMMServer <ServerConnection>]
   [[-VirtualNetworkAdapter] <VirtualNetworkAdapter>]
   -VirtualNetwork <String>
   [-Checkpoint]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Set-SCVirtualNetworkAdapter コマンドレットは、仮想マシン、仮想マシン テンプレート、または仮想マシン マネージャー (VMM) 環境での仮想マシンの作成に使用されるハードウェア プロファイルに関連付けられている仮想ネットワーク アダプターの 1 つ以上のプロパティを変更します。

実行できる操作は次のとおりです。

  • 仮想ネットワーク アダプタを仮想ネットワークに接続します。

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

  • 仮想ネットワーク アダプターのネットワークの場所とネットワーク タグを指定します。

  • 仮想ネットワーク アダプターで MAC アドレスを指定します。

  • 仮想ローカル エリア ネットワーク (VLAN) の使用を有効にし、仮想ネットワーク アダプターでその VLAN の VLAN ID (数値識別子) を指定します。

注意

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

例 1: 仮想ネットワーク アダプターを仮想ネットワークに接続する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.PhysicalAddress -eq "00:16:D3:CC:00:1B" }
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -VirtualNetwork "ExternalVirtualNetwork01"

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

2 番目のコマンドは、VM01 上のすべての仮想ネットワーク アダプター オブジェクトを取得し、物理 (MAC) アドレスが 00:16:D3:CC:00:1B のアダプター オブジェクトを選択し、そのオブジェクトを $Adapter 変数に格納します。

最後のコマンドは、$Adapterに格納されている仮想ネットワーク アダプターを、VM01 を含むホスト上の ExternalVirtualNetwork01 という名前の仮想ネットワークに接続します。

例 2: 仮想ネットワーク アダプターの静的 MAC アドレスを指定する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.ID -eq "5c0ee80a-731f-41c8-92f0-85a1619f9a1b" }
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -PhysicalAddressType "Static" -PhysicalAddress "00:16:D3:CC:00:1C"

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

2 番目のコマンドは、VM02 上のすべての仮想ネットワーク アダプター オブジェクトを取得し、指定した ID を持つ仮想ネットワーク アダプターを選択し、そのオブジェクトを $Adapter 変数に格納します。 この例では、このアダプターに現在動的 MAC アドレスがあることを前提としています。

最後のコマンドは、$Adapterに格納されている仮想ネットワーク アダプターが静的 MAC アドレス 00:16:D3:CC:00:1C を使用することを指定します。

例 3: 静的 MAC アドレスを指定し、既存の仮想ネットワーク アダプターに割り当てる

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter (Get-VirtualNetworkAdapter -VM $VM | where { $_.ID -eq "95e9cfda-861c-44a3-b2ba-2f796dfe691c"}) -MACAddressType "Static" -MACAddress "00-00-00-00-00-00"

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

2 番目のコマンドは、VM03 上の仮想ネットワーク アダプター オブジェクトを ID で取得し、アダプターが静的 MAC アドレスの種類を使用することを指定し、MAC アドレスを割り当てます。

例 4: 指定された仮想ネットワーク アダプターを仮想ネットワークから切断する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapters[1] -NoConnection

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

2 番目のコマンドは、VM04 上のすべての仮想ネットワーク アダプター オブジェクトを取得し、アダプター オブジェクトを$Adaptersに格納します。 この例では、VM04 に少なくとも 2 つの仮想ネットワーク アダプターがあることを前提としています。

最後のコマンドでは 、NoConnection パラメーターを使用して、接続先の仮想ネットワークから 2 番目の仮想ネットワーク アダプター (Adapters[1]) を切断します。

例 5: 既存の仮想マシンの VMware ポート グループを指定する

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapter = $VM.VirtualNetworkAdapters[0]
PS C:\> Set-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter -VMwarePortGroup "VM Network"

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

2 番目のコマンドは、VM05 上の最初の [0] 仮想ネットワーク アダプターを $Adapter 変数に格納します。

最後のコマンドは、$Adapterに格納されているアダプターの仮想ネットワーク アダプターを VM ネットワークに設定します。これは、このアダプターを接続する VMware ポート グループの名前です。

パラメーター

-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 の一覧を指定します。

Note

このパラメーターは、VMM 2019 UR3 に適用されます。

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

-Checkpoint

チェックポイント可能アクセス許可を使用することを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
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 Offload をサポートするネットワーク アダプターを使用する仮想マシンのネットワーク パフォーマンスが向上します。 VMQ を使用すると、仮想ネットワーク アダプターごとに一意のネットワーク キューを作成できます。 TCP Chimney Offload を使用すると、ネットワーク トラフィック処理をネットワーク スタックからオフロードできます。

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

-IPv4Addresses

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

Type:System.Collections.Generic.List`1[System.String]
Aliases:IPv4Address
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv4AddressPools

IPv4 アドレス プールの一覧を指定します。

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:IPv4AddressPool
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

-IPv6Addresses

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

Type:System.Collections.Generic.List`1[System.String]
Aliases:IPv6Address
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPv6AddressPools

IPv6 アドレス プールの一覧を指定します。

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.StaticIPAddressPool]
Aliases:IPv6AddressPool
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

-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

-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

-NoLogicalNetwork

この仮想ネットワーク アダプターに論理ネットワークが関連付けられていないことを示します。

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

-NoPortClassification

ポート分類が指定されていないことを示します。

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

-RemovePortACL

この操作によってポート アクセス制御リスト (ACL) が削除されることを示します。

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

-RequiredBandwidth

ネットワーク アダプターに必要なネットワーク帯域幅を指定します。

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

-SlotID

デバイスを識別するために使用する数値 ID を指定します。

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

-VirtualNetwork

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

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

-VirtualNetworkAdapter

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

ホストの種類は、次の数の仮想ネットワーク アダプターをサポートします。

  • Hyper-V。 仮想マシンあたり最大 4 つのエミュレートされたアダプター。 Windows Server 2003 x64 ゲスト オペレーティング システムでエミュレートされたネットワーク アダプターに使用できるドライバーはありません。

  • Hyper-V。 仮想マシンあたり最大 8 つの合成アダプター。

  • VMware ESX。 仮想マシンあたり最大 4 つのエミュレートされたアダプター。

  • Citrix XenServer。 仮想マシンあたり最大 7 つのエミュレートされたアダプター。

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

-VLanEnabled

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

  • 例: -VLANEnabled -VLANID 35
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanID

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

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

形式の例: -VLanEnabled -VLANID 35

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

-VMMServer

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

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

-VMNetwork

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

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

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

-VMNetworkServiceSetting

VM ネットワーク サービスの設定を指定します。

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

-VMwarePortGroup

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

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

出力

VirtualNetworkAdapter

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

メモ

  • Get-SCVirtualNetworkAdapter コマンドレットを使用して取得できる VMM 仮想ネットワーク アダプター オブジェクトが必要です。