Remove-SCVirtualMachine

Remove-SCVirtualMachine
    [-VM] <VM>
    [-SkipFileRemoval]
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-WhatIf]
    [-Confirm]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Mit dem Cmdlet Remove-SCVirtualMachine wird ein VM-Objekt entfernt, das auf einem Host bereitgestellt oder auf einem Virtual Machine Manager (VMM)-Bibliothekserver gespeichert ist.

Mit diesem Cmdlet wird der Datensatz der virtuellen Maschine aus der VMM-Datenbank gelöscht, alle Dateien gelöscht, die der virtuellen Maschine zugeordnet sind, und die virtuelle Maschine vom Host, auf dem sie bereitgestellt wird, oder vom Bibliothekserver, auf dem sie gespeichert ist, entfernt.

Wenn ein Ordner auf einem Host für diese virtuelle Maschine von VMM und nicht von Hyper-V oder VMware erstellt wurde und dieser Ordner keine anderen virtuellen Maschinen oder andere Daten enthält, können Sie den Ordner über das Dateisystem löschen, nachdem Sie die virtuelle Maschine entfernt haben.

Wenn Sie den Force-Parameter angeben, löscht dieses Cmdlet nur den virtuellen Computer aus der VMM-Datenbank. Die virtuelle Maschine selbst wird nicht gelöscht.

Dieses Cmdlet gibt bei Erfolg das Objekt zurück, das den Wert $True für die MarkedForDeletion-Eigenschaft aufweist. Wenn ein Fehler auftritt, gibt das Cmdlet eine Fehlermeldung zurück.

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.VMHost.Name -eq "VMHost01.Contoso.com" -and $_.Name -eq "VM01" }
PS C:\> Remove-SCVirtualMachine -VM $VM

Mit dem ersten Befehl wird das VM-Objekt mit dem Namen VM01 abgerufen, das auf VMHost01 bereitgestellt wurde, und dann das VM-Objekt in der Variablen $VM gespeichert.

Der zweite Befehl entfernt das in $VM gespeicherte Objekt und löscht die entsprechenden Dateien der virtuellen Maschine aus dem Dateisystem auf seinem Host.

PS C:\> $VMs = @(Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -Match "VM0" } )
PS C:\> $VMs | Remove-SCVirtualMachine

Mit dem ersten Befehl werden alle VM-Objekte abgerufen, die auf einem beliebigen Host implementiert sind, dessen Name die Zeichenfolge VM0 enthält, und dann werden diese VM-Objekte in dem Array mit dem Namen $VMs gespeichert.

Der zweite Befehl entfernt jedes Objekt der virtuellen Maschine im $VMs-Array und löscht die entsprechenden Dateien der virtuellen Maschine aus dem Dateisystem auf jedem Host.

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer1.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "VM02" }
PS C:\> Remove-SCVirtualMachine -VM $VM

Der erste Befehl ruft das Objekt ab, das den virtuellen Computer mit dem Namen VM03 darstellt, und speichert dann das Objekt des virtuellen Computers in $VM. In diesem Beispiel ist nur ein virtueller Computer mit dem Namen VM03 vorhanden.

Der zweite Befehl entfernt das Objekt, das VM03 darstellt, aus der Bibliothek und löscht die entsprechenden Dateien der virtuellen Maschine aus dem Dateisystem auf dem Bibliothekserver.

PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "VM0" }
PS C:\> $VMs | Remove-SCVirtualMachine -Confirm

Mit dem ersten Befehl werden alle VM-Objekte abgerufen, deren Namen die Zeichenfolge VM0 enthalten und die auf LibraryServer01 gespeichert sind. Der Befehl speichert dann die Objekte der virtuellen Maschine in dem Array mit dem Namen $VMs.

Der zweite Befehl übergibt jedes in $VMs gespeicherte VM-Objekt an das aktuelle Cmdlet, das jedes Objekt aus der Bibliothek entfernt und die entsprechenden VM-Dateien aus dem Dateisystem auf dem Bibliothekserver löscht. Der Parameter Confirm fordert Sie auf, zu bestätigen, ob Sie jede dieser virtuellen Maschinen löschen möchten.

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.

Für dieses Cmdlet ist ein VMM-VMM-Objekt erforderlich, das mit dem Cmdlet Get-SCVirtualMachine abgerufen werden kann.