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 entfernt eine oder mehrere virtuelle Netzwerkadapterobjekte aus einem virtuellen Computer, einer virtuellen Computervorlage oder einem Hardwareprofil, das in einer Virtual Machine Manager -Umgebung (VMM) verwendet wird.

Dieses Cmdlet gibt das Objekt nach Erfolg (mit der Eigenschaft "MarkedForDeletion" auf $True festgelegt) zurück oder gibt eine Fehlermeldung zurück.

Beispiele

Beispiel 1: Entfernen eines virtuellen Netzwerkadapters mit der angegebenen MAC-Adresse aus 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 virtuelle Computerobjekt namens VM01 ab und speichert das Objekt in der $VM Variable.

Der zweite Befehl ruft das virtuelle Netzwerkadapterobjekt auf VM01 ab, das die angegebene MAC-Adresse enthält 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 aus einem virtuellen Computer verbunden ist

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 virtuelle Computerobjekt namens VM02 ab und speichert das Objekt in der $VM Variable.

Der zweite Befehl ruft das virtuelle Netzwerkadapterobjekt auf VM02 ab, das mit dem angegebenen virtuellen Netzwerk verbunden ist und das Objekt in der $Adapter Variable speichert.

Mit dem letzten Befehl wird das in "$Adapter" gespeicherte virtuelle Netzwerkadapterobjekt von "VM02" entfernt.

Beispiel 3: Entfernen des einzigen virtuellen Netzwerkadapters aus 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 virtuelle Computerobjekt namens VM03 ab und speichert das Objekt in der $VM Variable.

Der zweite Befehl ruft das virtuelle Netzwerkadapterobjekt auf VM03 ab und speichert das Objekt in der $Adapter Variable. 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 virtuelle Netzwerkadapterobjekt.

Beispiel 4: Entfernen aller virtuellen Netzwerkadapter aus 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 virtuelle Computerobjekt namens VM04 ab und speichert das Objekt in der $VM Variable.

Der zweite Befehl ruft alle virtuellen Netzwerkadapterobjekte auf VM04 ab und speichert die Objekte im $Adapters-Objektarray.

Der letzte Befehl übergibt jedes in $Adapters gespeicherte Objekt an Remove-SCVirtualNetworkAdapter, das jedes virtuelle Netzwerkadapterobjekt aus VM04 entfernt.

Beispiel 5: Entfernen des zweiten virtuellen Netzwerkadapters aus 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 virtuelle Computerobjekt namens VM05 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl ruft alle virtuellen Netzwerkadapterobjekte auf VM05 ab und speichert die Objekte im $Adapters-Objektarray. In diesem Beispiel wird davon ausgegangen, dass VM05 drei virtuelle Netzwerkadapter enthält.

Der letzte Befehl übergibt das zweite virtuelle Netzwerkadapterobjekt ($Adapters [1]) an das Cmdlet Remove-SCVirtualNetworkAdapter , das dieses virtuelle Netzwerkadapterobjekt 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 Auftrag 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. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Auftrag 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 der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die 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, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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 von virtuellen Netzwerkadaptern:

  • Hyper-V. Bis zu vier emulierte Adapter pro virtuellen Computer. Es gibt keinen Treiber für einen emulierten Netzwerkadapter auf einem Windows Server 2003 x64-Gastbetriebssystem.
  • 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.