Remove-SCVirtualNetworkAdapter
Rimuove un oggetto scheda di rete virtuale da VMM.
Sintassi
Remove-SCVirtualNetworkAdapter
[-VirtualNetworkAdapter] <VirtualNetworkAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Remove-SCVirtualNetworkAdapter
-SlotID <Int32>
-JobGroup <Guid>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Descrizione
Il cmdlet remove-SCVirtualNetworkAdapter
Questo cmdlet restituisce l'oggetto in caso di esito positivo (con la proprietà MarkedForDeletion impostata su $True) o restituisce un messaggio di errore in caso di errore.
Esempio
Esempio 1: Rimuovere una scheda di rete virtuale con l'indirizzo MAC specificato da una macchina 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:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter
Il primo comando ottiene l'oggetto macchina virtuale denominato VM01 e archivia l'oggetto nella variabile $VM.
Il secondo comando ottiene l'oggetto scheda di rete virtuale in VM01 con l'indirizzo MAC specificato e archivia l'oggetto nella variabile $Adapter.
L'ultimo comando rimuove la scheda di rete virtuale archiviata in $Adapter da VM01.
Esempio 2: Rimuovere una scheda di rete virtuale connessa a una rete virtuale specifica da una macchina virtuale
PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.VirtualNetwork -eq "ExternalVirtualNetwork01" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter
Il primo comando ottiene l'oggetto macchina virtuale denominato VM02 e archivia l'oggetto nella variabile $VM.
Il secondo comando ottiene l'oggetto scheda di rete virtuale in VM02 connesso alla rete virtuale specificata e archivia l'oggetto nella variabile $Adapter.
L'ultimo comando rimuove l'oggetto scheda di rete virtuale archiviato in $Adapter da VM02.
Esempio 3: Rimuovere l'unica scheda di rete virtuale da una macchina virtuale
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter
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 e archivia l'oggetto nella variabile $Adapter. In questo esempio si presuppone che VM03 abbia una sola scheda di rete virtuale.
L'ultimo comando rimuove l'oggetto scheda di rete virtuale archiviato in $Adapter da VM03.
Esempio 4: Rimuovere tutte le schede di rete virtuale da una macchina virtuale
PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters | Remove-SCVirtualNetworkAdapter
Il primo comando ottiene l'oggetto macchina virtuale denominato VM04 e archivia l'oggetto nella variabile $VM.
Il secondo comando ottiene tutti gli oggetti della scheda di rete virtuale in VM04 e archivia gli oggetti nella matrice di oggetti $Adapters.
L'ultimo comando passa ogni oggetto archiviato in $Adapters a Remove-SCVirtualNetworkAdapter, che rimuove ogni oggetto scheda di rete virtuale da VM04.
Esempio 5: Rimuovere la seconda scheda di rete virtuale da una macchina virtuale con tre schede di rete virtuale
PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters[1] | Remove-SCVirtualNetworkAdapter
Il primo comando ottiene l'oggetto macchina virtuale denominato VM05 e archivia l'oggetto nella variabile $VM.
Il secondo comando ottiene tutti gli oggetti della scheda di rete virtuale in VM05 e archivia gli oggetti nella matrice di oggetti $Adapters. In questo esempio si presuppone che VM05 abbia tre schede di rete virtuale.
L'ultimo comando passa il secondo oggetto scheda di rete virtuale ($Adapters [1]) all'cmdlet Remove-SCVirtualNetworkAdapter, che rimuove questo oggetto scheda di rete virtuale da VM05.
Parametri
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posizione: | Named |
Valore predefinito: | False |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-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: | True |
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 |
-OnBehalfOfUser
Specifica un nome utente. Questo cmdlet opera per conto dell'utente specificato da questo parametro.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-OnBehalfOfUserRole
Specifica un ruolo utente.
Per ottenere un ruolo utente, usare il cmdlet Get-SCUserRole
Tipo: | UserRole |
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 |
-SlotID
Specifica un ID numerico usato per identificare un dispositivo.
Tipo: | Int32 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | 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 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 macchina virtuale.
- VMware ESX. Fino a quattro schede emulate per macchina virtuale.
- Citrix XenServer. Fino a sette schede emulate per macchina virtuale.
Tipo: | VirtualNetworkAdapter |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-WhatIf
Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.
Tipo: | SwitchParameter |
Alias: | wi |
Posizione: | Named |
Valore predefinito: | False |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
Note
- Richiede un oggetto scheda di rete virtuale VMM, che può essere recuperato usando il cmdlet get-SCVirtualNetworkAdapter .