Share via

Set-SCVirtualNetworkAdapter

  • Riferimento
Modulo:
VirtualMachineManager

Modifica le proprietà di una scheda di rete virtuale associata a una macchina virtuale, un modello di macchina virtuale o un profilo hardware usato per creare macchine virtuali in VMM.

Sintassi

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

Descrizione

Il cmdlet Set-SCVirtualNetworkAdapter modifica una o più proprietà di una scheda di rete virtuale associata a una macchina virtuale, un modello di macchina virtuale o un profilo hardware usato per creare macchine virtuali in un ambiente VMM (Virtual Machine Manager).

Le operazioni che è possibile eseguire includono quanto segue:

  • Connettere una scheda di rete virtuale a una rete virtuale.

  • Disconnettere una scheda di rete virtuale da una rete virtuale.

  • Specificare un percorso di rete e un tag di rete in una scheda di rete virtuale.

  • Specificare un indirizzo MAC nella scheda di rete virtuale.

  • Abilitare l'uso di una rete locale virtuale (VLAN) e specificare un ID VLAN (identificatore numerico) per tale VLAN nella scheda di rete virtuale.

Nota

  • Un nuovo parametro [-PhysicalNetworkAdapterName] è incluso in VMM 2019 UR2 e versioni successive. Per altre informazioni, vedere Parametri.
  • I nuovi parametri [-AllowedVLanList] e [-NativeVLanId] sono inclusi in VMM 2019 UR3 e versioni successive. Per altre informazioni, vedere Parametri.

Esempio

Esempio 1: Connettere una scheda di rete virtuale a una rete virtuale

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"

Il primo comando ottiene l'oggetto macchina virtuale denominato VM01 e archivia l'oggetto nella variabile $VM.

Il secondo comando ottiene tutti gli oggetti scheda di rete virtuale in VM01, seleziona l'oggetto adapter con l'indirizzo MAC fisico (MAC) 00:16:D3:CC:00:1B e quindi archivia l'oggetto nella variabile $Adapter.

L'ultimo comando connette la scheda di rete virtuale archiviata in $Adapter alla rete virtuale denominata ExternalVirtualNetwork01 nell'host contenente VM01.

Esempio 2: Specificare un indirizzo MAC statico per una scheda di rete virtuale

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"

Il primo comando ottiene l'oggetto macchina virtuale denominato VM02 e archivia l'oggetto nella variabile $VM.

Il secondo comando ottiene tutti gli oggetti della scheda di rete virtuale in VM02, seleziona la scheda di rete virtuale con l'ID specificato e quindi archivia l'oggetto nella variabile $Adapter. In questo esempio si presuppone che questa scheda abbia attualmente un indirizzo MAC dinamico.

L'ultimo comando specifica che la scheda di rete virtuale archiviata in $Adapter usa l'indirizzo MAC statico 00:16:D3:CC:00:1C.

Esempio 3: Specificare un indirizzo MAC statico e assegnarlo a una scheda di rete virtuale esistente

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"

Il primo comando ottiene l'oggetto macchina virtuale denominato VM03 e archivia l'oggetto nella variabile $VM.

Il secondo comando ottiene l'oggetto scheda di rete virtuale in VM03 per ID, specifica che l'adattatore usa un tipo di indirizzo MAC statico e lo assegna a un indirizzo MAC.

Esempio 4: Disconnettere la scheda di rete virtuale specificata dalla rete virtuale

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

Il primo comando ottiene l'oggetto macchina virtuale denominato VM04 e archivia l'oggetto nella variabile $VM.

Il secondo comando ottiene tutti gli oggetti scheda di rete virtuale in VM04 e archivia gli oggetti adapter in $Adapters. In questo esempio si presuppone che vm04 abbia almeno due schede di rete virtuale.

L'ultimo comando usa il parametro NoConnection per disconnettere la seconda scheda di rete virtuale (adapter[1]) da qualsiasi rete virtuale a cui è connesso.

Esempio 5: Specificare un gruppo di porte VMware per una macchina virtuale esistente

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

Il primo comando ottiene l'oggetto macchina virtuale denominato VM05 e archivia l'oggetto nella variabile $VM.

Il secondo comando archivia la prima scheda di rete virtuale [0] in VM05 nella variabile $Adapter.

L'ultimo comando imposta la scheda di rete virtuale per la scheda archiviata in $Adapter alla rete VM, ovvero il nome del gruppo di porte VMware a cui si vuole connettersi questa scheda.

Parametri

-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

Specifica un elenco di LAN virtuali consentite in una scheda di rete della macchina virtuale.

Nota

Questo parametro è applicabile per VMM 2019 UR3 e versioni successive.

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

-Checkpoint

Indica di usare l'autorizzazione Can Checkpoint.

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

-DevicePropertiesAdapterName

Specifica il nome di una scheda di rete.

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

-DevicePropertiesAdapterNameMode

Specifica la modalità nome dell'adattatore.

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

-EnableGuestIPNetworkVirtualizationUpdates

Indica se gli aggiornamenti della virtualizzazione della rete IP da parte di un guest sono abilitati.

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

-EnableMACAddressSpoofing

Abilita, se impostato su $True, lo spoofing dell'indirizzo MAC.

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

-EnableVMNetworkOptimization

Abilita, se impostata su $True, ottimizzazione della rete di macchine virtuali.

Questa funzionalità migliora le prestazioni di rete per le macchine virtuali con schede di rete che supportano la coda di macchine virtuali (VMQ) o TCP Chimney Offload. VMQ consente di creare una coda di rete univoca per ogni scheda di rete virtuale. TCP Chimney Offload consente di disattivare l'elaborazione del traffico di rete dallo stack di rete.

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

-IPv4Addresses

Specifica un elenco di indirizzi 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

Specifica un elenco di pool di indirizzi 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

Specifica un tipo di indirizzo IPv4. I valori validi per questo parametro sono:

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

-IPv6Addresses

Specifica un elenco di indirizzi 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

Specifica un elenco di pool di indirizzi 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

Specifica un tipo di indirizzo IPv6. I valori validi per questo parametro sono:

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

-JobGroup

Specifica un identificatore per una serie di comandi che verranno eseguiti come un insieme prima dell'esecuzione dell'ultimo comando che include lo stesso identificatore di gruppo di processi.

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

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

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

-LogicalNetwork

Specifica una rete logica. Una rete logica è un raggruppamento denominato di subnet IP e VLAN usati per organizzare e semplificare le assegnazioni di rete.

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

-MACAddress

Specifica l'indirizzo MAC o un set di indirizzi MAC per una scheda di rete fisica o virtuale in un computer.

  • Formato di esempio per un singolo indirizzo MAC: -MACAddress "00-15-5D-B4-DC-00"
  • Formato di esempio per un set di indirizzi 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

Specifica il tipo di indirizzo MAC da usare per una scheda di rete virtuale. I valori validi sono: Statico, Dinamico.

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

-NativeVLanId

Specifica l'identificatore di LAN virtuale nativo per una scheda di rete della macchina virtuale.

Nota

Questo parametro è applicabile per VMM 2019 UR3 e versioni successive.

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

-NetworkLocation

Specifica il percorso di rete per una scheda di rete fisica o per una scheda di rete virtuale oppure modifica il percorso di rete predefinito di una scheda di rete fisica dell'host.

Formati di esempio:

  • -NetworkLocation $NetLoc ($NetLoc potrebbe contenere 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

Specifica una parola o una frase da associare a una scheda di rete virtuale configurata per connettersi a una specifica rete interna o esterna sull'host.

Il parametro NetworkTag identifica tutte le macchine virtuali con lo stesso NetworkTag dei membri della stessa rete. VMM usa un NeworkTag (se esistente) quando valuta gli host il più possibile candidati in cui distribuire una macchina virtuale. Se l'host non include macchine virtuali nella rete con lo stesso NetworkTag della macchina virtuale da inserire, l'host riceve zero stelle nel processo di posizionamento.

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

-NoConnection

Disconnette una scheda di rete virtuale da una rete virtuale.

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

-NoLogicalNetwork

Indica che nessuna rete logica è associata a questa scheda di rete virtuale.

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

-NoPortClassification

Indica che non viene fornita una classificazione delle porte.

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

-OnBehalfOfUser

Specifica un nome utente. Questo cmdlet opera per conto dell'utente che specifica questo parametro.

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

-OnBehalfOfUserRole

Specifica un ruolo utente. Per ottenere un ruolo utente, usare il cmdlet Get-SCUserRole . Questo cmdlet opera per conto del ruolo utente specificato da questo parametro.

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

-PhysicalNetworkAdapterName

Specifica il nome della scheda di rete fisica.

Nota

Questo parametro è applicabile per VMM 2019 UR2 e versioni successive.

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

-PortACL

Specifica un oggetto ACL di porta.

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

-PortClassification

Specifica la classificazione delle porte del commutatore a cui si connette la scheda di rete virtuale.

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

-PROTipID

Specifica l'ID del suggerimento prestazioni e ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti PRO.

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

-RemovePortACL

Indica che questa operazione rimuove l'elenco di controllo di accesso della porta .

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

-RequiredBandwidth

Specifica la larghezza di banda di rete richiesta da una scheda di rete.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo restituisca immediatamente la shell dei comandi.

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

-SlotID

Specifica un ID numerico usato per identificare un dispositivo.

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

-VirtualNetwork

Specifica un oggetto rete virtuale.

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

-VirtualNetworkAdapter

Specifica un oggetto scheda di rete virtuale per una macchina virtuale.

I tipi di host supportano il numero di schede di rete virtuale seguenti:

  • Hyper-V. Fino a quattro schede emulate per ogni macchina virtuale. Non è disponibile alcun driver per una scheda di rete emulata in un sistema operativo guest windows Server 2003 x64.

  • Hyper-V. Fino a otto schede sintetiche per ogni macchina virtuale.

  • VMware ESX. Fino a quattro schede emulate per ogni macchina virtuale.

  • Citrix XenServer. Fino a sette schede emulate per ogni macchina virtuale.

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

-VLanEnabled

Indica se abilitare una rete LAN virtuale per l'uso da parte di macchine virtuali in un host Hyper-V o Citrix XenServer.

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

-VLanID

Assegna un identificatore numerico nell'intervallo 1-4094 a una scheda di rete virtuale in una macchina virtuale o a una scheda di rete fisica in un host di macchine virtuali.

Configurare un VLanID in una scheda di rete virtuale di una macchina virtuale associata a una scheda di rete fisica nell'host o associata a una rete virtuale interna nell'host.

Formato di esempio: -VLanEnabled -VLANID 35

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

-VMMServer

Specifica un oggetto server Virtual Machine Manager.

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

-VMNetwork

Specifica un oggetto di rete della macchina virtuale.

Per ottenere un oggetto di rete vm, usare il cmdlet Get-SCVMNetwork .

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

-VMNetworkServiceSetting

Specifica un'impostazione del servizio di rete vm.

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

-VMSubnet

Specifica un oggetto subnet della macchina virtuale.

Per ottenere un oggetto VMSubnet , usare il cmdlet Get-SCVMSubnet .

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

-VMwarePortGroup

Specifica il gruppo di porte VMware.

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

Output

VirtualNetworkAdapter

Questo cmdlet restituisce un oggetto VirtualNetworkAdapter .

Note

  • Richiede un oggetto scheda di rete virtuale VMM, che può essere recuperato usando il cmdlet Get-SCVirtualNetworkAdapter .