Remove-SCVirtualNetworkAdapter
Entfernt ein virtuelles Netzwerkadapterobjekt aus 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>] Beschreibung
Das Cmdlet Remove-SCVirtualNetworkAdapter entfernt mindestens ein virtuelles Netzwerkadapterobjekt aus einem virtuellen Computer, einer virtuellen Computervorlage oder einem Hardwareprofil, das in einer VMM-Umgebung (Virtual Machine Manager) verwendet wird.
Dieses Cmdlet gibt das Objekt nach Erfolg zurück (mit der Eigenschaft MarkedForDeletion auf $True festgelegt) oder eine Fehlermeldung beim Fehler zurück.
Beispiele
Beispiel 1: Entfernen eines virtuellen Netzwerkadapters mit der angegebenen MAC-Adresse von einem virtuellen Computer
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 $AdapterDer erste Befehl ruft das virtuelle Computerobjekt mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.
Der zweite Befehl ruft das Objekt des virtuellen Netzwerkadapters auf VM01 ab, das die angegebene MAC-Adresse aufweist und das Objekt in der $Adapter Variablen speichert.
Der letzte Befehl entfernt den virtuellen Netzwerkadapter, der in $Adapter von VM01 gespeichert ist.
Beispiel 2: Entfernen eines virtuellen Netzwerkadapters, der mit einem bestimmten virtuellen Netzwerk verbunden ist, von einem virtuellen Computer
PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM | where { $_.VirtualNetwork -eq "ExternalVirtualNetwork01" }
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $AdapterDer erste Befehl ruft das virtuelle Computerobjekt mit dem Namen VM02 ab und speichert das Objekt in der $VM Variablen.
Der zweite Befehl ruft das Objekt des virtuellen Netzwerkadapters auf VM02 ab, das mit dem angegebenen virtuellen Netzwerk verbunden ist, und speichert das Objekt in der $Adapter Variablen.
Mit dem letzten Befehl wird das in "$Adapter" gespeicherte virtuelle Netzwerkadapterobjekt von "VM02" entfernt.
Beispiel 3: Entfernen des einzigen virtuellen Netzwerkadapters von einem virtuellen Computer
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $Adapter = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> Remove-SCVirtualNetworkAdapter -VirtualNetworkAdapter $AdapterDer erste Befehl ruft das virtuelle Computerobjekt mit dem Namen VM03 ab und speichert das Objekt in der $VM Variablen.
Der zweite Befehl ruft das Objekt des virtuellen Netzwerkadapters auf VM03 ab und speichert das Objekt in der $Adapter Variablen. In diesem Beispiel wird davon ausgegangen, dass VM03 nur über einen virtuellen Netzwerkadapter verfügt.
Der letzte Befehl entfernt das in $Adapter von VM03 gespeicherte Objekt des virtuellen Netzwerkadapters.
Beispiel 4: Entfernen aller virtuellen Netzwerkadapter von einem virtuellen Computer
PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters | Remove-SCVirtualNetworkAdapterDer erste Befehl ruft das virtuelle Computerobjekt mit dem Namen VM04 ab und speichert das Objekt in der $VM Variablen.
Der zweite Befehl ruft alle Objekte des virtuellen Netzwerkadapters auf VM04 ab und speichert die Objekte im $Adapters Objektarray.
Der letzte Befehl übergibt jedes In $Adapters gespeicherte Objekt an Remove-SCVirtualNetworkAdapter, wodurch jedes virtuelle Netzwerkadapterobjekt von VM04 entfernt wird.
Beispiel 5: Entfernen des zweiten virtuellen Netzwerkadapters von einem virtuellen Computer mit drei virtuellen Netzwerkadaptern
PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters[1] | Remove-SCVirtualNetworkAdapterDer erste Befehl ruft das virtuelle Computerobjekt mit dem Namen VM05 ab und speichert das Objekt in der $VM Variablen.
Der zweite Befehl ruft alle Objekte des virtuellen Netzwerkadapters auf VM05 ab und speichert die Objekte im $Adapters-Objektarray. In diesem Beispiel wird davon ausgegangen, dass VM05 über drei virtuelle Netzwerkadapter verfügt.
Der letzte Befehl übergibt das zweite objekt des virtuellen Netzwerkadapters ($Adapters [1]) an das Cmdlet Remove-SCVirtualNetworkAdapter , das dieses objekt des virtuellen Netzwerkadapters aus VM05 entfernt.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Gibt einen Bezeichner für eine Reihe von Befehlen an, die als Satz unmittelbar vor dem letzten Befehl, der den gleichen Auftragsgruppenbezeichner enthält, ausgeführt werden.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, den dieser Parameter angibt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Gibt eine Benutzerrolle an. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die dieser Parameter angibt.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SlotID
Gibt eine numerische ID an, die zum Identifizieren eines Geräts verwendet wird.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VirtualNetworkAdapter
Gibt ein virtuelles Netzwerkadapterobjekt für eine virtuelle Maschine an.
Typen von Hosts unterstützen die folgende Anzahl virtueller Netzwerkadapter:
- Hyper-V. Bis zu vier emulierte Adapter pro virtuellen Computer. Es ist kein Treiber für einen emulierten Netzwerkadapter auf einem Windows Server 2003 x64-Gastbetriebssystem verfügbar.
- Hyper-V. Bis zu acht synthetische Adapter pro virtuellen Computer.
- VMware ESX. Bis zu vier emulierte Adapter pro virtuellen Computer.
- Citrix XenServer. Bis zu sieben emulierte Adapter pro virtuellen Computer.
| Type: | VirtualNetworkAdapter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Hinweise
- Erfordert ein virtuelles VMM-Netzwerkadapterobjekt, das mithilfe des Cmdlets Get-SCVirtualNetworkAdapter abgerufen werden kann.