Delen via

Remove-SCVirtualNetworkAdapter

  • Referentie
Module:
VirtualMachineManager

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

Syntax

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

Met de cmdlet Remove-SCVirtualNetworkAdapter worden een of meer virtuele netwerkadapterobjecten verwijderd 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 object van de virtuele netwerkadapter 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.

De laatste opdracht verwijdert het virtuele-netwerkadapterobject dat in $Adapter is opgeslagen van VM02.

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

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: Verwijder alle virtuele netwerkadapters van een virtuele machine

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, waarmee elk object van de virtuele netwerkadapter uit VM04 wordt verwijderd.

Voorbeeld 5: De tweede virtuele netwerkadapter verwijderen 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 uit VM05 wordt verwijderd.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam op. Deze cmdlet werkt namens de gebruiker die met deze parameter wordt opgegeven.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 door deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SlotID

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

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetworkAdapter

Hiermee geeft u een object voor een virtuele netwerkadapter 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
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Notities

  • Hiervoor is een virtueel VMM-netwerkadapterobject vereist, dat kan worden opgehaald met behulp van de cmdlet Get-SCVirtualNetworkAdapter .