Dela via

Set-SCVirtualNetworkAdapter

  • Referens
Modul:
VirtualMachineManager

Ändrar egenskaper för ett virtuellt nätverkskort som är associerat med en virtuell dator, en mall för virtuella datorer eller en maskinvaruprofil som används för att skapa virtuella datorer i 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

Cmdleten Set-SCVirtualNetworkAdapter ändrar en eller flera egenskaper för ett virtuellt nätverkskort som är associerat med en virtuell dator, mall för virtuella datorer eller maskinvaruprofil som används för att skapa virtuella datorer i en VMM-miljö (Virtual Machine Manager).

Åtgärder som du kan utföra omfattar följande:

  • Anslut ett virtuellt nätverkskort till ett virtuellt nätverk.

  • Koppla från ett virtuellt nätverkskort från ett virtuellt nätverk.

  • Ange en nätverksplats och en nätverkstagg på ett virtuellt nätverkskort.

  • Ange en MAC-adress på det virtuella nätverkskortet.

  • Aktivera användningen av ett virtuellt lokalt nätverk (VLAN) och ange ett VLAN-ID (numerisk identifierare) för det virtuella nätverkskortet på det virtuella nätverkskortet.

Anteckning

  • En ny parameter [-PhysicalNetworkAdapterName] ingår i VMM 2019 UR2. Mer information finns i Parametrar.
  • Nya parametrar [-AllowedVLanList] och [-NativeVLanId] ingår i VMM 2019 UR3. Mer information finns i Parametrar.

Exempel

Exempel 1: Ansluta ett virtuellt nätverkskort till ett virtuellt nätverk

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"

Det första kommandot hämtar det virtuella datorobjektet VM01 och lagrar objektet i variabeln $VM.

Det andra kommandot hämtar alla virtuella nätverkskortsobjekt på VM01, väljer adapterobjektet med den fysiska (MAC)-adressen 00:16:D3:CC:00:1B och lagrar sedan objektet i variabeln $Adapter.

Det senaste kommandot ansluter det virtuella nätverkskortet som lagras i $Adapter till det virtuella nätverket med namnet ExternalVirtualNetwork01 på värden som innehåller VM01.

Exempel 2: Ange en statisk MAC-adress för ett virtuellt nätverkskort

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"

Det första kommandot hämtar det virtuella datorobjektet VM02 och lagrar objektet i variabeln $VM.

Det andra kommandot hämtar alla virtuella nätverkskortsobjekt på VM02, väljer det virtuella nätverkskortet med angivet ID och lagrar sedan objektet i variabeln $Adapter. Det här exemplet förutsätter att det här kortet för närvarande har en dynamisk MAC-adress.

Det sista kommandot anger att det virtuella nätverkskortet som lagras i $Adapter använda den statiska MAC-adressen 00:16:D3:CC:00:1C.

Exempel 3: Ange en statisk MAC-adress och tilldela den till ett befintligt virtuellt nätverkskort

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"

Det första kommandot hämtar det virtuella datorobjektet VM03 och lagrar objektet i variabeln $VM.

Det andra kommandot hämtar det virtuella nätverkskortsobjektet på VM03 efter ID, anger att kortet använder en statisk MAC-adresstyp och tilldelar det en MAC-adress.

Exempel 4: Koppla bort det angivna virtuella nätverkskortet från det virtuella nätverket

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

Det första kommandot hämtar det virtuella datorobjektet VM04 och lagrar objektet i variabeln $VM.

Det andra kommandot hämtar alla virtuella nätverkskortsobjekt på VM04 och lagrar kortobjekten i $Adapters. Det här exemplet förutsätter att VM04 har minst två virtuella nätverkskort.

Det senaste kommandot använder parametern NoConnection för att koppla från det andra virtuella nätverkskortet (Kort[1]) från alla virtuella nätverk som det är anslutet till.

Exempel 5: Ange en VMware-portgrupp för en befintlig virtuell dator

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

Det första kommandot hämtar det virtuella datorobjektet VM05 och lagrar objektet i variabeln $VM.

Det andra kommandot lagrar det första virtuella nätverkskortet [0] på VM05 i variabeln $Adapter.

Det senaste kommandot anger det virtuella nätverkskortet för det kort som lagras i $Adapter till VM-nätverk, vilket är namnet på den VMware-portgrupp som du vill att det här kortet ska ansluta till.

Parametrar

-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

Anger en lista över virtuella LAN som tillåts på ett virtuellt datornätverkskort.

Anteckning

Den här parametern gäller för VMM 2019 UR3.

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

-Checkpoint

Anger att behörigheten Kan kontrollpunkt ska användas.

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

-DevicePropertiesAdapterName

Anger namnet på ett nätverkskort.

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

-DevicePropertiesAdapterNameMode

Anger nätverkskortets namnläge.

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

-EnableGuestIPNetworkVirtualizationUpdates

Anger om ip-nätverksvirtualiseringsuppdateringar av en gäst är aktiverad.

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

-EnableMACAddressSpoofing

Aktiverar, när det är inställt på $True, MAC-adressförfalskning.

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

-EnableVMNetworkOptimization

Aktiverar nätverksoptimering för virtuella datorer när det är inställt på $True.

Den här funktionen förbättrar nätverksprestanda för virtuella datorer med nätverkskort som stöder VMQ (Virtual Machine Queue) eller TCP Chimney Offload. MED VMQ kan du skapa en unik nätverkskö för varje virtuellt nätverkskort. TCP Chimney Offload gör att bearbetning av nätverkstrafik kan avlastas från nätverksstacken.

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

-IPv4Addresses

Anger en lista över IPv4-adresser.

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

Anger en lista över IPv4-adresspooler.

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

Anger en IPv4-adresstyp. De acceptabla värdena för den här parametern är:

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

-IPv6Addresses

Anger en lista över IPv6-adresser.

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

Anger en lista över IPv6-adresspooler.

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

Anger en IPv6-adresstyp. De acceptabla värdena för den här parametern är:

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

-JobGroup

Anger en identifierare för en serie kommandon som ska köras som en uppsättning precis innan det slutliga kommandot som innehåller samma jobbgruppsidentifierare körs.

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

-JobVariable

Anger att jobbstatus spåras och lagras i variabeln som heter av den här parametern.

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

-LogicalNetwork

Anger ett logiskt nätverk. Ett logiskt nätverk är en namngiven gruppering av IP-undernät och VLAN som används för att organisera och förenkla nätverkstilldelningar.

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

-MACAddress

Anger MAC-adressen, eller en uppsättning MAC-adresser, för ett fysiskt eller virtuellt nätverkskort på en dator.

  • Exempelformat för en enskild MAC-adress: -MACAddress "00-15-5D-B4-DC-00"
  • Exempelformat för en uppsättning MAC-adresser: -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

Anger vilken typ av MAC-adress som ska användas för ett virtuellt nätverkskort. Giltiga värden är: Statisk, Dynamisk.

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

-NativeVLanId

Anger den interna virtuella LAN-identifieraren för ett virtuellt datornätverkskort.

Anteckning

Den här parametern gäller för VMM 2019 UR3.

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

-NetworkLocation

Anger nätverksplatsen för ett fysiskt nätverkskort eller för ett virtuellt nätverkskort, eller ändrar standardnätverksplatsen för en värds fysiska nätverkskort.

Exempelformat:

  • -NetworkLocation $NetLoc ($NetLoc kan innehålla 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

Anger ett ord eller en fras som ska associeras med ett virtuellt nätverkskort som är konfigurerat för att ansluta till ett specifikt internt eller externt nätverk på värden.

Parametern NetworkTag identifierar alla virtuella datorer med samma NetworkTag som medlemmar i samma nätverk. VMM använder en NeworkTag (om en sådan finns) när den utvärderar värdar som möjliga kandidater för att distribuera en virtuell dator. Om värden inte innehåller virtuella datorer i nätverket med samma NetworkTag som den virtuella dator som ska placeras, får värden noll stjärnor i placeringsprocessen.

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

-NoConnection

Kopplar från ett virtuellt nätverkskort från ett virtuellt nätverk.

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

-NoLogicalNetwork

Anger att inget logiskt nätverk är associerat med det här virtuella nätverkskortet.

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

-NoPortClassification

Anger att det inte finns någon portklassificering.

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

-OnBehalfOfUser

Anger ett användarnamn. Den här cmdleten fungerar för användarens räkning som den här parametern anger.

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

-OnBehalfOfUserRole

Anger en användarroll. Om du vill hämta en användarroll använder du cmdleten Get-SCUserRole . Den här cmdleten fungerar för den användarroll som den här parametern anger.

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

-PhysicalNetworkAdapterName

Anger namnet på det fysiska nätverkskortet.

Anteckning

Den här parametern gäller för VMM 2019 UR2.

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

-PortACL

Anger ett port-ACL-objekt.

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

-PortClassification

Anger portklassificeringen för växeln som det virtuella nätverkskortet ansluter till.

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

-PROTipID

Anger ID för tipset prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

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

-RemovePortACL

Anger att den här åtgärden tar bort portåtkomstkontrollistan (ACL).

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

-RequiredBandwidth

Anger den nätverksbandbredd som krävs av ett nätverkskort.

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

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.

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

-SlotID

Anger ett numeriskt ID som används för att identifiera en enhet.

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

-VirtualNetwork

Anger ett virtuellt nätverksobjekt.

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

-VirtualNetworkAdapter

Anger ett virtuellt nätverkskortsobjekt för en virtuell dator.

Typer av värdar stöder följande antal virtuella nätverkskort:

  • Hyper-V. Upp till fyra emulerade kort per virtuell dator. Det finns ingen tillgänglig drivrutin för ett emulerat nätverkskort på ett Windows Server 2003 x64-gästoperativsystem.

  • Hyper-V. Upp till åtta syntetiska kort per virtuell dator.

  • VMware ESX. Upp till fyra emulerade kort per virtuell dator.

  • Citrix XenServer. Upp till sju emulerade kort per virtuell dator.

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

-VLanEnabled

Anger om ett virtuellt LAN (VLAN) ska aktiveras för användning av virtuella datorer på en Hyper-V- eller Citrix XenServer-värd.

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

-VLanID

Tilldelar en numerisk identifierare i intervallet 1–4094 till ett virtuellt nätverkskort på en virtuell dator eller till ett fysiskt nätverkskort på en virtuell datorvärd.

Konfigurera ett VLanID på ett virtuellt nätverkskort för en virtuell dator som är bunden till ett fysiskt nätverkskort på värden eller bundet till ett internt virtuellt nätverk på värden.

Exempelformat: -VLanEnabled -VLANID 35

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

-VMMServer

Anger ett VMM-serverobjekt.

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

-VMNetwork

Anger ett virtuellt datornätverksobjekt.

Om du vill hämta ett VM-nätverksobjekt använder du cmdleten Get-SCVMNetwork .

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

-VMNetworkServiceSetting

Anger en tjänstinställning för virtuellt datornätverk.

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

-VMSubnet

Anger ett undernätsobjekt för en virtuell dator.

Om du vill hämta ett VMSubnet-objekt använder du cmdleten Get-SCVMSubnet .

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

-VMwarePortGroup

Anger VMware-portgruppen.

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

Utdata

VirtualNetworkAdapter

Den här cmdleten returnerar ett VirtualNetworkAdapter-objekt .

Kommentarer

  • Kräver ett VMM-objekt för virtuellt nätverkskort som kan hämtas med hjälp av cmdleten Get-SCVirtualNetworkAdapter .