Sdílet prostřednictvím

Set-SCVirtualNetworkAdapter

  • Reference
Modul:
VirtualMachineManager

Změní vlastnosti virtuálního síťového adaptéru přidruženého k virtuálnímu počítači, šabloně virtuálního počítače nebo hardwarovému profilu použitému k vytvoření virtuálních počítačů v nástroji VMM.

Syntax

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>]

Description

Rutina Set-SCVirtualNetworkAdapter změní jednu nebo více vlastností virtuálního síťového adaptéru přidruženého k virtuálnímu počítači, šabloně virtuálního počítače nebo hardwarovému profilu použitému k vytvoření virtuálních počítačů v prostředí Nástroje Virtual Machine Manager (VMM).

Mezi operace, které můžete provést, patří:

  • Připojte virtuální síťový adaptér k virtuální síti.

  • Odpojte virtuální síťový adaptér od virtuální sítě.

  • Zadejte síťové umístění a značku sítě na virtuálním síťovém adaptéru.

  • Zadejte adresu MAC na virtuálním síťovém adaptéru.

  • Povolte použití virtuální místní sítě (VLAN) a zadejte ID sítě VLAN (číselný identifikátor) pro tuto síť VLAN na virtuálním síťovém adaptéru.

Poznámka

  • Nový parametr [-PhysicalNetworkAdapterName] je součástí VMM 2019 UR2. Další informace najdete v tématu Parametry.
  • Nové parametry [-AllowedVLanList] a [-NativeVLanId] jsou součástí VMM 2019 UR3. Další informace najdete v tématu Parametry.

Příklady

Příklad 1: Připojení virtuálního síťového adaptéru k virtuální síti

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"

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží objekt do proměnné $VM.

Druhý příkaz získá všechny objekty virtuálního síťového adaptéru na virtuálním počítači VM01, vybere objekt adaptéru s fyzickou adresou (MAC) 00:16:D3:CC:00:1B a pak uloží objekt do proměnné $Adapter.

Poslední příkaz připojí virtuální síťový adaptér uložený v $Adapter k virtuální síti s názvem ExternalVirtualNetwork01 na hostiteli, který obsahuje virtuální počítač VM01.

Příklad 2: Určení statické adresy MAC pro virtuální síťový adaptér

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"

První příkaz získá objekt virtuálního počítače s názvem VM02 a uloží objekt do proměnné $VM.

Druhý příkaz získá všechny objekty virtuálního síťového adaptéru na virtuálním počítači VM02, vybere virtuální síťový adaptér se zadaným ID a pak uloží objekt do proměnné $Adapter. Tento příklad předpokládá, že tento adaptér má aktuálně dynamickou adresu MAC.

Poslední příkaz určuje, že virtuální síťový adaptér uložený v $Adapter použít statickou adresu MAC 00:16:D3:CC:00:1C.

Příklad 3: Zadejte statickou adresu MAC a přiřaďte ji k existujícímu virtuálnímu síťovému adaptéru.

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"

První příkaz získá objekt virtuálního počítače s názvem VM03 a uloží objekt do proměnné $VM.

Druhý příkaz získá objekt virtuálního síťového adaptéru na virtuálním počítači VM03 podle ID, určuje, že adaptér používá statický typ adresy MAC a přiřadí ji adresu MAC.

Příklad 4: Odpojení zadaného virtuálního síťového adaptéru od virtuální sítě

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

První příkaz získá objekt virtuálního počítače s názvem VM04 a uloží objekt do proměnné $VM.

Druhý příkaz získá všechny objekty virtuálního síťového adaptéru na virtuálním počítači VM04 a uloží objekty adaptéru do $Adapters. Tento příklad předpokládá, že virtuální počítač VM04 má alespoň dva virtuální síťové adaptéry.

Poslední příkaz používá parametr NoConnection k odpojení druhého virtuálního síťového adaptéru (Adaptéry[1]) z jakékoli virtuální sítě, ke které je připojen.

Příklad 5: Určení skupiny portů VMware pro existující virtuální počítač

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

První příkaz získá objekt virtuálního počítače s názvem VM05 a uloží objekt do proměnné $VM.

Druhý příkaz ukládá první virtuální síťový adaptér [0] na virtuálním počítači VM05 do proměnné $Adapter.

Poslední příkaz nastaví virtuální síťový adaptér pro adaptér uložený v $Adapter na síť virtuálních počítačů, což je název skupiny portů VMware, ke které se má tento adaptér připojit.

Parametry

-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

Určuje seznam virtuálních sítí LAN povolených na síťovém adaptéru virtuálního počítače.

Poznámka

Tento parametr platí pro VMM 2019 UR3.

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

-Checkpoint

Označuje, že se má použít oprávnění Může kontrolní bod.

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

-DevicePropertiesAdapterName

Určuje název síťového adaptéru.

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

-DevicePropertiesAdapterNameMode

Určuje režim názvu adaptéru.

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

-EnableGuestIPNetworkVirtualizationUpdates

Označuje, jestli je povolená virtualizace sítě IP podle hosta.

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

-EnableMACAddressSpoofing

Povolí se při nastavení na $True falšování adres MAC.

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

-EnableVMNetworkOptimization

Povolí se při nastavení na $True optimalizace sítě virtuálních počítačů.

Tato funkce zlepšuje výkon sítě pro virtuální počítače s síťovými adaptéry, které podporují frontu virtuálních počítačů (VMQ) nebo přesměrování načítání TCP Chimney. VMQ umožňuje vytvořit jedinečnou síťovou frontu pro každý virtuální síťový adaptér. Přesměrování zátěže TCP Chimney umožňuje přesměrování zpracování síťového provozu ze síťového zásobníku.

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

-IPv4Addresses

Určuje seznam adres 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

Určuje seznam fondů adres 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

Určuje typ adresy IPv4. Tento parametr přijímá tyto hodnoty:

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

-IPv6Addresses

Určuje seznam adres 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

Určuje seznam fondů adres 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

Určuje typ adresy IPv6. Tento parametr přijímá tyto hodnoty:

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

-JobGroup

Určuje identifikátor řady příkazů, které se budou spouštět jako sada těsně před posledním příkazem, který obsahuje stejný identifikátor skupiny úloh.

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

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

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

-LogicalNetwork

Určuje logickou síť. Logická síť je pojmenované seskupení podsítí IP a sítí VLAN, které slouží k uspořádání a zjednodušení přiřazení sítě.

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

-MACAddress

Určuje adresu MAC nebo sadu adres MAC pro fyzický nebo virtuální síťový adaptér v počítači.

  • Příklad formátu pro jednu adresu MAC: -MACAddress "00-15-5D-B4-DC-00"
  • Příklad formátu sady adres 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

Určuje typ adresy MAC, kterou se má použít pro virtuální síťový adaptér. Platné hodnoty jsou: Static, Dynamic.

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

-NativeVLanId

Určuje nativní identifikátor virtuální sítě LAN pro síťový adaptér virtuálního počítače.

Poznámka

Tento parametr platí pro VMM 2019 UR3.

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

-NetworkLocation

Určuje síťové umístění fyzického síťového adaptéru nebo virtuálního síťového adaptéru nebo změní výchozí síťové umístění fyzického síťového adaptéru hostitele.

Příklady formátů:

  • -NetworkLocation $NetLoc ($NetLoc může obsahovat 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

Určuje slovo nebo frázi, které chcete přidružit k virtuálnímu síťovému adaptéru, který je nakonfigurovaný pro připojení ke konkrétní interní nebo externí síti na hostiteli.

Parametr NetworkTag identifikuje všechny virtuální počítače se stejnou značkou NetworkTag jako členy stejné sítě. Nástroj VMM používá funkci NeworkTag (pokud existuje), když vyhodnotí hostitele jako možné kandidáty, na kterých se má virtuální počítač nasadit. Pokud hostitel neobsahuje virtuální počítače v síti se stejnou značkou NetworkTag jako virtuální počítač, který se má umístit, hostitel obdrží v procesu umístění nula hvězdiček.

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

-NoConnection

Odpojí virtuální síťový adaptér od virtuální sítě.

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

-NoLogicalNetwork

Označuje, že k tomuto virtuálnímu síťovému adaptéru není přidružená žádná logická síť.

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

-NoPortClassification

Označuje, že není k dispozici klasifikace portů.

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

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.

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

-OnBehalfOfUserRole

Určuje roli uživatele. K získání role uživatele použijte rutinu Get-SCUserRole . Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.

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

-PhysicalNetworkAdapterName

Určuje název fyzického síťového adaptéru.

Poznámka

Tento parametr platí pro VMM 2019 UR2.

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

-PortACL

Určuje objekt seznamu ACL portu.

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

-PortClassification

Určuje klasifikaci portů přepínače, ke kterému se virtuální síťový adaptér připojuje.

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

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (tip PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

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

-RemovePortACL

Označuje, že tato operace odebere seznam řízení přístupu portu (ACL).

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

-RequiredBandwidth

Určuje šířku pásma sítě vyžadovanou síťovým adaptérem.

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

-RunAsynchronously

Označuje, že úloha se spouští asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

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

-SlotID

Určuje číselné ID použité k identifikaci zařízení.

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

-VirtualNetwork

Určuje objekt virtuální sítě.

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

-VirtualNetworkAdapter

Určuje objekt virtuálního síťového adaptéru pro virtuální počítač.

Typy hostitelů podporují následující počet virtuálních síťových adaptérů:

  • Hyper-V. Až čtyři emulované adaptéry na virtuální počítač. Pro emulovaný síťový adaptér v hostovaném operačním systému Windows Server 2003 x64 není k dispozici žádný ovladač.

  • Hyper-V. Až osm syntetických adaptérů na virtuální počítač.

  • VMware ESX. Až čtyři emulované adaptéry na virtuální počítač.

  • Citrix XenServer. Až sedm emulovaných adaptérů na virtuální počítač.

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

-VLanEnabled

Určuje, jestli chcete povolit virtuální síť LAN (VLAN) pro použití virtuálními počítači na hostiteli Hyper-V nebo Citrix XenServer.

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

-VLanID

Přiřadí číselný identifikátor v rozsahu 1–4094 virtuálnímu síťovému adaptéru na virtuálním počítači nebo fyzickému síťovému adaptéru na hostiteli virtuálního počítače.

Nakonfigurujte VLanID na virtuálním síťovém adaptéru virtuálního počítače vázaného na fyzický síťový adaptér na hostiteli nebo vázaný na interní virtuální síť na hostiteli.

Příklad formátu: -VLanEnabled -VLANID 35

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

-VMMServer

Určuje objekt serveru VMM.

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

-VMNetwork

Určuje síťový objekt virtuálního počítače.

K získání síťového objektu virtuálního počítače použijte rutinu Get-SCVMNetwork .

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

-VMNetworkServiceSetting

Určuje nastavení síťové služby virtuálního počítače.

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

-VMSubnet

Určuje objekt podsítě virtuálního počítače.

K získání objektu VMSubnet použijte rutinu Get-SCVMSubnet .

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

-VMwarePortGroup

Určuje skupinu portů VMware.

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

Výstupy

VirtualNetworkAdapter

Tato rutina vrátí objekt VirtualNetworkAdapter .

Poznámky

  • Vyžaduje objekt virtuálního síťového adaptéru VMM, který lze načíst pomocí rutiny Get-SCVirtualNetworkAdapter .