Remove-SCVirtualNetworkAdapter
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
De cmdlet Remove-SCVirtualNetworkAdapter 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 (met de eigenschap MarkedForDeletion ingesteld op $True) of retourneert een foutbericht bij 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 object van de virtuele machine met de naam VM04 opgehaald en wordt het object opgeslagen in de variabele $VM.
Met de tweede opdracht worden alle objecten van virtuele netwerkadapters 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: 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 object van de virtuele machine met de naam VM05 opgehaald en wordt het object opgeslagen in de $VM variabele.
Met de tweede opdracht worden alle objecten van virtuele netwerkadapters 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 object van de virtuele netwerkadapter 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. 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 met 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 van 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 .