Condividi tramite

Add-SCVMHostNetworkAdapter

  • Riferimento
Modulo:
VirtualMachineManager

Aggiunge una scheda di rete fisica in un host gestito da VMM a una rete virtuale.

Sintassi

Add-SCVMHostNetworkAdapter
   -VirtualNetwork <VirtualNetwork>
   [-VLanEnabled]
   [-VLanMode <VlanMode>]
   [-VLanID <UInt16>]
   [-VLanTrunkID <UInt16[]>]
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Descrizione

Il cmdlet add-SCVMHostNetworkAdapter aggiunge una scheda di rete fisica (detta anche scheda di interfaccia di rete o scheda di interfaccia di rete) in un host gestito da Virtual Machine Manager (VMM) a una rete virtuale. Ogni macchina virtuale in tale host può anche connettersi tramite una scheda di rete virtuale a tale rete virtuale.

Una rete virtuale configurata in un host può connettersi a più schede di rete virtuali nelle macchine virtuali distribuite in tale host.

VMM per System Center 2019 e versioni successive include il supporto delle reti virtuali per la configurazione di una o più reti locali virtuali (VLAN) in un host. È possibile usare il cmdlet Add-SCVMHostNetworkAdapter o il cmdlet Set-SCVMHostNetworkAdapter per configurare una singola VLAN o più VLAN in un host. Per configurare le impostazioni VLAN corrispondenti in una macchina virtuale, usare il cmdlet New-SCVirtualNetworkAdapter o il cmdlet Set-SCVirtualNetworkAdapter.

Per un'illustrazione di ogni tipo di VLAN, vedere gli esempi per questo cmdlet.

Esempio

Esempio 1: Aggiungere una scheda di rete host fisica a una rete virtuale

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork01"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter

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

Il secondo comando ottiene l'oggetto di rete virtuale denominato ExternalVirtualNetwork01 in VMHost01 e archivia l'oggetto nella variabile $VirtualNetwork.

Il terzo comando ottiene l'oggetto scheda di rete fisica denominato HostAdapter01 in VMHost01 e archivia l'oggetto nella variabile $VMHostNetworkAdapter.

L'ultimo comando aggiunge HostAdapter01 a ExternalVirtualNetwork01.

Nota: è possibile aggiungere una sola scheda host fisica per ogni rete virtuale. Pertanto, l'ultimo comando avrà esito negativo se una scheda è già associata alla rete virtuale specificata. Per aggiungere una nuova scheda alla rete virtuale, è prima necessario rimuovere la scheda host esistente.

Esempio 2: Aggiungere una scheda di rete host fisica a una VLAN che usa la modalità "Trunk"

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalNetwork02"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter02"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

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

Il secondo comando ottiene l'oggetto di rete virtuale denominato ExternalNetwork02 in VMHost02 e archivia l'oggetto nella variabile $VirtualNetwork.

Il terzo comando ottiene l'oggetto scheda di rete denominato HostAdapter02 in VMHost02 e archivia l'oggetto adapter nella variabile $VMHostNetworkAdapter.

L'ultimo comando aggiunge HostAdapter02 alla rete virtuale ExternalNetwork02 e abilita l'accesso da ExternalNetwork02 a un dispositivo di rete esterno usando vLAN con tag 802.1Q 1, 2, 100, 200 e 1124.

Nota: è possibile aggiungere una sola scheda host per ogni rete virtuale, quindi l'ultimo comando avrà esito negativo se una scheda è già associata alla rete virtuale specificata.

Esempio 3: Aggiungere una scheda di rete host fisica a una VLAN che usa la modalità "Access"

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork03"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter03"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLanEnabled -VLanMode "Access" -VLanID 22

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

Il secondo comando ottiene l'oggetto di rete virtuale denominato ExternalNetwork03 in VMHost03 e archivia l'oggetto nella variabile $VirtualNetwork.

Il terzo comando ottiene l'oggetto scheda di rete denominato HostAdapter03 in VMHost03 e archivia l'oggetto adapter nella variabile$VMHostNetworkAdapter.

L'ultimo comando aggiunge HostAdapter03 alla rete virtuale ExternalNetwork03 e limita l'accesso a ExternalNetwork03 a VLANID 22.

Nota: è possibile aggiungere una sola scheda host per ogni rete virtuale, quindi l'ultimo comando avrà esito negativo se una scheda è già associata alla rete virtuale specificata.

Attenzione: in questo esempio si presuppone che l'host sia già connesso a una VLAN o, in caso contrario, assicurarsi 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. È possibile eseguire i passaggi descritti in questo esempio in un host con una sola scheda di rete se si installa prima l'adapter Loopback Microsoft nel server.

Parametri

-JobGroup

Specifica un identificatore per una serie di comandi che verranno eseguiti come set subito prima dell'esecuzione del comando finale che include lo stesso identificatore del gruppo di processi.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobVariable

Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PROTipID

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

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VirtualNetwork

Specifica un oggetto di rete virtuale.

Tipo:VirtualNetwork
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VLanEnabled

Abilita una rete LAN virtuale (VLAN) da usare da 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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VLanID

Assegna un identificatore numerico compreso nell'intervallo da 1 a 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

Tipo:UInt16
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VLanMode

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

Tipo:VlanMode
Valori accettati:Access, Trunk, Invalid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VLanTrunkID

Assegna un elenco di identificatori numerici nell'intervallo da 1 a 4094 a una scheda di rete fisica in un host Hyper-V.

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

Tipo:UInt16[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VMHostNetworkAdapter

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

Formato di esempio: -VMHostNetworkAdapter $VMHostNIC

Tipo:HostNetworkAdapter
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Output

VMHostNetworkAdapter

Questo cmdlet restituisce un oggetto VMHostNetworkAdapter.