Add-SCVMHostNetworkAdapter
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ò essere connessa a più schede di rete virtuali nelle macchine virtuali distribuite nell'host in questione.
VMM per System Center 2019 e versioni successive include il supporto di rete virtuale 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 una descrizione di ogni tipo di VLAN, vedere gli esempi relativi a tale 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 $VMHostNetworkAdapterIl 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,1124Il 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 tramite VLAN con tag 802.1Q 1, 2, 100, 200 e 1124.
Nota: è possibile aggiungere una sola scheda host per ogni rete virtuale, pertanto 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 22Il 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, pertanto 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 di questo esempio in un host con una sola scheda di rete se prima si installa la scheda Microsoft Loopback nel server.
Parametri
-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 |
-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 |
-VirtualNetwork
Specifica un oggetto rete virtuale.
| Type: | VirtualNetwork |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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: | SwitchParameter |
| 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 .