Remove-SCVirtualNetworkAdapter

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

Mit dem Cmdlet Remove-SCVirtualNetworkAdapter wird ein oder mehrere Objekte des virtuellen Netzwerkadapters aus einem virtuellen Computer, einer VM-Vorlage oder einem Hardwareprofil entfernt, das in einer VMM-Umgebung (Virtual Machine Manager) verwendet wird.

Dieses Cmdlet gibt das Objekt bei Erfolg zurück (wobei die Eigenschaft MarkedForDeletion auf $True festgelegt ist) oder gibt eine Fehlermeldung zurück, wenn ein Fehler auftritt.

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.

Mit dem zweiten Befehl wird das Objekt des virtuellen Netzwerkadapters auf VM01 abgerufen, das über die angegebene MAC-Adresse verfügt, und das Objekt in der Variablen $Adapter gespeichert.

Mit dem letzten Befehl wird der in $Adapter gespeicherte virtuelle Netzwerkadapter von VM01 entfernt.

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 VM-Objekt mit dem Namen VM02 ab und speichert das Objekt in der Variablen $VM.

Mit dem zweiten Befehl wird das Objekt des virtuellen Netzwerkadapters auf VM02 abgerufen, das mit dem angegebenen virtuellen Netzwerk verbunden ist, und das Objekt in der Variablen $Adapter gespeichert.

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

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 VM-Objekt mit dem Namen VM03 ab und speichert das Objekt in der Variablen $VM.

Mit dem zweiten Befehl wird das Objekt des virtuellen Netzwerkadapters auf VM03 abgerufen und in der Variablen $Adapter gespeichert. In diesem Beispiel wird davon ausgegangen, dass VM03 nur über einen virtuellen Netzwerkadapter verfügt.

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

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters | Remove-SCVirtualNetworkAdapter

Der erste Befehl ruft das VM-Objekt mit dem Namen VM04 ab und speichert das Objekt in der Variablen $VM.

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 Objekt des virtuellen Netzwerkadapters von VM04 entfernt wird.

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $Adapters = Get-SCVirtualNetworkAdapter -VM $VM
PS C:\> $Adapters[1] | Remove-SCVirtualNetworkAdapter

Mit dem ersten Befehl wird das VM-Objekt mit dem Namen VM05 abgerufen und in der Variablen $VM gespeichert.

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 von VM05 entfernt.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

• Erfordert ein VMM-Objekt für einen virtuellen Netzwerkadapter, das mit dem Cmdlet Get-SCVirtualNetworkAdapter abgerufen werden kann.