Freigeben über

Remove-SCVirtualNetworkAdapter

  • Referenz
Modul:
VirtualMachineManager

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 Cmdlet entfernt mindestens ein Virtuelles Netzwerkadapterobjekt von 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 (wobei die Eigenschaft "MarkedForDeletion" auf $True festgelegt ist) oder bei Einem Fehler eine Fehlermeldung zurückgibt.

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 $Adapter

Der erste Befehl ruft das Objekt des virtuellen Computers mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl ruft das Virtuelle Netzwerkadapterobjekt auf VM01 ab, das über die angegebene MAC-Adresse verfügt, und speichert das Objekt in der $Adapter Variablen.

Mit dem letzten Befehl wird der virtuelle Netzwerkadapter entfernt, 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 $Adapter

Der erste Befehl ruft das Objekt des virtuellen Computers namens VM02 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl ruft das Virtuelle Netzwerkadapterobjekt 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 virtuelle Netzwerkadapterobjekt entfernt, das in $Adapter von VM02 gespeichert ist.

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 $Adapter

Der erste Befehl ruft das Objekt des virtuellen Computers namens 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.

Mit dem letzten Befehl wird das virtuelle Netzwerkadapterobjekt entfernt, das in $Adapter von VM03 gespeichert ist.

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

Der erste Befehl ruft das Objekt des virtuellen Computers namens 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 aus 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-SCVirtualNetworkAdapter

Der erste Befehl ruft das Objekt des virtuellen Computers namens 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 virtuelle Netzwerkadapterobjekt ($Adapters [1]) an das cmdlet Remove-SCVirtualNetworkAdapter Cmdlet, das dieses Objekt des virtuellen Netzwerkadapters von VM05 entfernt.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobGroup

Gibt einen Bezeichner für eine Reihe von Befehlen an, die direkt vor dem endgültigen Befehl ausgeführt werden, der denselben Auftragsgruppenbezeichner enthält.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SlotID

Gibt eine numerische ID an, die zum Identifizieren eines Geräts verwendet wird.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VirtualNetworkAdapter

Gibt ein Virtuelles Netzwerkadapterobjekt für einen virtuellen Computer an.

Typen von Hosts unterstützen die folgende Anzahl von virtuellen Netzwerkadaptern:

  • 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.
Typ:VirtualNetworkAdapter
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Hinweise

  • Erfordert ein virtuelles VMM-Netzwerkadapterobjekt, das mithilfe des Cmdlets Get-SCVirtualNetworkAdapter abgerufen werden kann.