Delen via

Remove-SCVirtualNetworkAdapter

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een object van een virtuele netwerkadapter uit VMM.

Syntaxis

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>]

Description

De Remove-SCVirtualNetworkAdapter cmdlet verwijdert een of meer virtuele netwerkadapterobjecten uit een virtuele machine, virtuele-machinesjabloon of hardwareprofiel dat wordt gebruikt in een VMM-omgeving (Virtual Machine Manager).

Deze cmdlet retourneert het object bij succes (waarbij de eigenschap MarkedForDeletion is ingesteld op $True) of retourneert een foutbericht bij een fout.

Voorbeelden

Voorbeeld 1: Een virtuele netwerkadapter verwijderen met het opgegeven MAC-adres van een virtuele machine

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

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM01 opgehaald en wordt het object opgeslagen in de $VM variabele.

Met de tweede opdracht wordt het virtuele netwerkadapterobject opgehaald op VM01 met het opgegeven MAC-adres en wordt het object opgeslagen in de $Adapter variabele.

Met de laatste opdracht verwijdert u de virtuele netwerkadapter die is opgeslagen in $Adapter van VM01.

Voorbeeld 2: Een virtuele netwerkadapter verwijderen die is verbonden met een specifiek virtueel netwerk van een virtuele machine

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.VirtualNetwork -eq "ExternalVirtualNetwork01" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM02 opgehaald en wordt het object opgeslagen in de $VM variabele.

Met de tweede opdracht wordt het object van de virtuele netwerkadapter opgehaald op VM02 dat is verbonden met het opgegeven virtuele netwerk en wordt het object opgeslagen in de $Adapter variabele.

Met de laatste opdracht wordt het object van de virtuele netwerkadapter verwijderd dat is opgeslagen in $Adapter van VM02.

Voorbeeld 3: De enige virtuele netwerkadapter van een virtuele machine verwijderen

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $Adapter

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM03 opgehaald en wordt het object opgeslagen in de $VM variabele.

Met de tweede opdracht wordt het object van de virtuele netwerkadapter op VM03 opgehaald en wordt het object opgeslagen in de $Adapter variabele. In dit voorbeeld wordt ervan uitgegaan dat VM03 slechts één virtuele netwerkadapter heeft.

Met de laatste opdracht wordt het object van de virtuele netwerkadapter verwijderd dat is opgeslagen in $Adapter van VM03.

Voorbeeld 4: Alle virtuele netwerkadapters van een virtuele machine verwijderen

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters | Remove-SCVirtualNetworkAdapter

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM04 opgehaald en wordt het object opgeslagen in de $VM variabele.

Met de tweede opdracht worden alle virtuele netwerkadapterobjecten op VM04 opgehaald en worden de objecten opgeslagen in de $Adapters objectmatrix.

Met de laatste opdracht wordt elk object dat is opgeslagen in $Adapters doorgegeven aan Remove-SCVirtualNetworkAdapter, waardoor elk object van de virtuele netwerkadapter uit VM04 wordt verwijderd.

Voorbeeld 5: Verwijder de tweede virtuele netwerkadapter van een virtuele machine met drie virtuele netwerkadapters

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters[1] | Remove-SCVirtualNetworkAdapter

Met de eerste opdracht wordt het virtuele-machineobject met de naam VM05 opgehaald en wordt het object opgeslagen in de $VM variabele.

Met de tweede opdracht worden alle virtuele netwerkadapterobjecten op VM05 opgehaald en worden de objecten opgeslagen in de $Adapters objectmatrix. In dit voorbeeld wordt ervan uitgegaan dat VM05 drie virtuele netwerkadapters heeft.

Met de laatste opdracht wordt het tweede object van de virtuele netwerkadapter ($Adapters [1]) doorgegeven aan de cmdlet Remove-SCVirtualNetworkAdapter, waarmee dit virtuele netwerkadapterobject van VM05 wordt verwijderd.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobGroup

Hiermee geeft u een id op voor een reeks opdrachten die worden uitgevoerd als een set vlak voor de laatste opdracht die dezelfde taakgroep-id bevat.

Type:Guid
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die deze parameter opgeeft.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die met deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SlotID

Hiermee geeft u een numerieke id op die wordt gebruikt om een apparaat te identificeren.

Type:Int32
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VirtualNetworkAdapter

Hiermee geeft u een virtuele netwerkadapterobject voor een virtuele machine.

Typen hosts ondersteunen het volgende aantal virtuele netwerkadapters:

  • Hyper-V. Maximaal vier geëmuleerde adapters per virtuele machine. Er is geen stuurprogramma beschikbaar voor een geëmuleerde netwerkadapter op een Windows Server 2003 x64-gastbesturingssysteem.
  • Hyper-V. Maximaal acht synthetische adapters per virtuele machine.
  • VMware ESX. Maximaal vier geëmuleerde adapters per virtuele machine.
  • Citrix XenServer. Maximaal zeven geëmuleerde adapters per virtuele machine.
Type:VirtualNetworkAdapter
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Notities

  • Hiervoor is een VMM-object voor virtuele netwerkadapters vereist, dat kan worden opgehaald met behulp van de Get-SCVirtualNetworkAdapter cmdlet.