Share via

Set-SCVMHostNetworkAdapter

  • Riferimento
Modulo:
VirtualMachineManager

Modifica le proprietà correlate alla rete per una scheda di rete fisica in un host gestito da VMM.

Sintassi

Set-SCVMHostNetworkAdapter
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-Description <String>]
   [-VLanMode <VlanMode>]
   [-AvailableForPlacement <Boolean>]
   [-UsedForManagement <Boolean>]
   [-SubnetVLan <SubnetVLan[]>]
   [-RemoveUnassignedVLan <UInt16[]>]
   [-AddOrSetLogicalNetwork <LogicalNetwork>]
   [-RemoveLogicalNetwork <LogicalNetwork>]
   [-EnableNetworkVirtualization <Boolean>]
   [-UplinkPortProfileSet <UplinkPortProfileSet>]
   [-RemoveUplinkPortProfileSet]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVMHostNetworkAdapter
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-Description <String>]
   [-VLanEnabled <Boolean>]
   [-VLanMode <VlanMode>]
   [-VLanID <UInt16>]
   [-VLanTrunkID <UInt16[]>]
   [-AvailableForPlacement <Boolean>]
   [-UsedForManagement <Boolean>]
   [-RemoveUnassignedVLan <UInt16[]>]
   [-EnableNetworkVirtualization <Boolean>]
   [-UplinkPortProfileSet <UplinkPortProfileSet>]
   [-RemoveUplinkPortProfileSet]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-SCVMHostNetworkAdapter modifica le proprietà correlate alla rete per una scheda di rete fisica in un host gestito da Virtual Machine Manager (VMM).

Le proprietà modificabili tramite questo cmdlet includono:

  • Impostazioni VLAN: è possibile usare i parametri VLAN per creare o modificare una singola VLAN o più VLAN. Per un'illustrazione di come specificare le impostazioni VLAN, vedere gli esempi.

Per altre informazioni sulle VLAN e altri esempi che illustrano le impostazioni VLAN, digitare Get-Help Add-SCVMHostNetworkAdapter -Detailed.

Esempio

Esempio 1: Creare una nuova rete virtuale in una scheda di rete host e specificare un ID VLAN per la rete virtuale

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost02.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost |  where {$_.Name -like "Intel(R) PRO/1000*" }
PS C:\> New-SCVirtualNetwork -Name "VirtualNetwork01" -VMHost $VMHost -VMHostNetworkAdapter $HostAdapter
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $HostAdapter -VLanEnabled $True -VLanMode "Access" -VLANID 35

Il primo comando ottiene l'oggetto host denominato VMHost02 e archivia l'oggetto nella variabile $VMHost.

Il secondo comando ottiene l'oggetto scheda di rete host con un nome che inizia con "Intel(R) PRO/1000 in VMHost02 e archivia l'oggetto nella variabile $HostAdapter.

Il terzo comando crea una rete virtuale denominata VirtualNetwork01 in VMHost02 associata alla scheda host archiviata in $HostAdapter.

L'ultimo comando abilita una VLAN, imposta la modalità su Access (che instrada il traffico internamente all'interno di una singola VLAN) e assegna alla scheda di rete un VLANID pari a 35.

Nota: questo esempio presuppone che l'host sia già connesso a una VLAN o, in caso contrario, che l'host abbia due schede di rete. Se l'host ha una singola scheda di rete, l'assegnazione della scheda a una VLAN non disponibile per il server VMM impedirà a VMM di gestire l'host.

Esempio 2: Aggiungere tag VLan a una scheda di rete host configurata in modalità trunk

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost03.Contoso.com"
PS C:\> $VMHostNIC = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "Adapter #3"
PS C:\> $NewVlanTags = $VMHostNIC.VlanTags + @(177,355,1012)
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $VMHostNIC -VLANEnabled $TRUE -VLanMode "Trunk" -VLanTrunkID $NewVLanTags

Il primo comando ottiene l'oggetto host denominato VMHost03 e archivia l'oggetto nella variabile $VMHost.

Il secondo comando ottiene l'oggetto scheda di rete host specificando il nome della scheda e archivia l'oggetto nella variabile $VMHostNIC.

Il terzo comando usa la proprietà VlanTags dell'oggetto scheda di rete host ($VMHostNIC.VlanTags) e concatena una nuova matrice di tag. La matrice aggiornata mantiene le VlanTag in corso e aggiunge i tag elencati alla matrice. Il risultato della concatenazione viene archiviato in $NewVlanTags.

L'ultimo comando passa il nuovo elenco di tag VLAN al parametro VLANTrunkID di Set-VMHostNetworkAdapter. Il parametro VLANMode deve specificare il valore "Trunk" ogni volta che viene usato il parametro VLANTrunkID per modificare l'elenco di identificatori numerici trunk VLAN.

Parametri

-AddOrSetLogicalNetwork

Specifica una rete logica che verrà aggiunta o aggiornata.

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

-AvailableForPlacement

Indica se il processo di posizionamento VMM considera questo host o questo volume in un host idoneo come percorso possibile in cui distribuire le macchine virtuali. Se questo parametro è impostato su $False, è possibile scegliere di distribuire comunque macchine virtuali in questo host o volume. Il valore predefinito è $True. Questo parametro non si applica agli host VMware ESX.

Quando questo parametro viene usato con le schede di rete, se impostato su $False, il posizionamento non considererà le reti logiche configurate in questa scheda di rete per determinare se l'host è adatto per la connessione di una macchina virtuale.

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

-Description

Indica una descrizione per l'oggetto specificato.

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

-EnableNetworkVirtualization

Specifica se la virtualizzazione di rete è abilitata. Il valore predefinito è $False.

Type:Boolean
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:False
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

-PROTipID

Specifica l'ID della descrizione per le prestazioni e l'ottimizzazione delle 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

-RemoveLogicalNetwork

Specifica una rete logica che verrà rimossa.

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

-RemoveUnassignedVLan

Specifica che le VLAN specificate verranno rimosse dal trunk VLAN della scheda se non sono associate a una rete logica.

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

-RemoveUplinkPortProfileSet

Rimuove il set di profili di porta uplink dalla scheda di rete host.

Type:SwitchParameter
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 torni immediatamente alla shell dei comandi.

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

-SubnetVLan

Specifica uno o più set di subnet IP e VLAN.

Per informazioni sulla creazione di una subnetVLan, digitare Get-Help New-SCSubNetVLan.

Type:SubnetVLan[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UplinkPortProfileSet

Specifica un oggetto set di profili di porta uplink.

Per ottenere un oggetto set di profili di porta uplink, usare il cmdlet Get-SCUplinkPortProfileSet .

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

-UsedForManagement

Indica se l'oggetto viene utilizzato per gestire gli host.

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

-VLanEnabled

Abilita una rete LAN virtuale (VLAN) per l'uso da parte di macchine virtuali in un host Hyper-V o Citrix XenServer.

  • Formato di esempio per una singola VLAN: -VLANEnabled -VLANMode "Access" -VLANID 35
  • Formato di esempio per più 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

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

Configurare un VLanID in un host Hyper-V, VMware ESX o Citrix XenServer:

  • In una scheda di rete fisica associata esternamente quando la modalità VLan è Access.

Configurare un VLanID in una scheda di rete virtuale di una macchina virtuale:

  • Associato a una scheda di rete fisica nell'host o
  • Associato a una rete virtuale interna nell'host.

Formato di esempio: -VLanEnabled -VLanMode "Access" -VLANID 35

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

-VLanMode

Specifica se una RETE LAN virtuale (VLAN) in un host di macchine virtuali supporta il traffico tra una singola VLAN (modalità di accesso) o tra più VLAN (modalità trunk). I valori validi sono: Access, Trunk.

Type:VlanMode
Accepted values:Access, Trunk, Invalid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanTrunkID

Assegna un elenco di identificatori numerici da 1 a 4094 a una scheda di rete fisica su un host Hyper-V.

Formato di esempio: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

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

-VMHostNetworkAdapter

Specifica un oggetto scheda di rete fisica in un host a cui possono connettersi le macchine virtuali distribuite in tale host.

Formato di esempio: -VMHostNetworkAdapter $VMHostNIC

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

Output

VMHostNetworkAdapter

Questo cmdlet restituisce un oggetto VMHostNetworkAdapter .