Condividi tramite

Remove-SCVirtualNetworkAdapter

  • Riferimento
Modulo:
VirtualMachineManager

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 rimuove uno o più oggetti scheda di rete virtuale da una macchina virtuale, un modello di macchina virtuale o un profilo hardware usato in un ambiente Virtual Machine Manager (VMM).

Questo cmdlet restituisce l'oggetto al completamento (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 da VM02 l'oggetto scheda di rete virtuale archiviato in $Adapter.

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. Questo esempio 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 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 scheda di rete virtuale in VM05 e archivia gli oggetti nella matrice di oggetti $Adapters. Questo esempio presuppone che VM05 abbia tre schede di rete virtuale.

L'ultimo comando passa il secondo oggetto scheda di rete virtuale ($Adapters [1]) al cmdlet Remove-SCVirtualNetworkAdapter , che rimuove questo oggetto scheda di rete virtuale da VM05.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-OnBehalfOfUser

Specifica un nome utente. Questo cmdlet opera per conto dell'utente specificato da 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

-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

-SlotID

Specifica un ID numerico utilizzato per identificare un dispositivo.

Type:Int32
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 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.
Type:VirtualNetworkAdapter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Note

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