Get-SCVMCheckpoint
Ruft Prüfpunkteobjekte des virtuellen Computers aus der VMM-Datenbank ab.
Syntax
Get-SCVMCheckpoint
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Get-SCVMCheckpoint
[-VM <VM>]
[-VMMServer <ServerConnection>]
[-MostRecent]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Get-SCVMCheckpoint
[-VMMServer <ServerConnection>]
[-ID <Guid>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Beschreibung
Das Cmdlet Get-SCVMCheckpoint ruft mindestens ein Prüfpunktobjekt des virtuellen Computers aus der VMM-Datenbank (Virtual Machine Manager) ab.
Ein Prüfpunkt für virtuelle Maschinen ist eine Momentaufnahmen einer virtuellen Maschine.
Sie können den Prüfpunkt verwenden, um einen virtuellen Computer auf einen vorherigen Zustand zurückzuverwenden.
Weitere Informationen zu VMM-Prüfpunkten geben Sie Get-Help New-VMCheckpoint -Detailedein.
Beispiele
Beispiel 1: Abrufen aller vorhandenen Prüfpunkte für jeden virtuellen Computer
PS C:\> Get-SCVMCheckpoint -VMMServer "VMMServer01.Contoso.com"Dieser Befehl ruft alle vorhandenen Prüfpunktobjekte für jeden virtuellen Computer ab, der von VMMServer01 verwaltet wird, und zeigt Informationen zu diesen Prüfpunktobjekten für den Benutzer an.
Beispiel 2: Abrufen aller Prüfpunkte für einen oder mehrere virtuelle Computer mit einem bestimmten Namen
PS C:\> $Checkpoints = Get-SCVMCheckpoint -VM "VM01"
PS C:\> $CheckpointsDer erste Befehl ruft alle Prüfpunktobjekte für virtuelle Computer VM01 ab und speichert die Objekte im $Checkpoints-Objektarray.
Der zweite Befehl zeigt Informationen zu den Prüfpunktobjekten in $Checkpoints an.
Beispiel 3: Abrufen des Hardwareprofils des zuletzt erstellten Prüfpunkts auf einer VM, die auf einem Hyper-V-Host bereitgestellt wird
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Checkpoint = $VM | Get-SCVMCheckpoint -MostRecent
PS C:\> $Checkpoint.CheckpointHWProfileDer erste Befehl ruft das virtuelle Computerobjekt mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.
Der zweite Befehl ruft das neueste Prüfpunktobjekt ab, das für VM01 erstellt wurde, und speichert das Objekt in der $Checkpoint Variablen.
Der letzte Befehl zeigt Informationen zum Hardwareprofil für prüfpunkt an, der in $Checkpoint gespeichert ist (das neueste Prüfpunktobjekt, das für VM01 erstellt wurde).
Beispiel 4: Anzeigen des .NET-Typs, Ereignisse, Methoden und Eigenschaften für Prüfpunktobjekte
PS C:\> $Checkpoints = Get-SCVMCheckpoint -VMMServer "VMMServer01.Contoso.com"
PS C:\> $Checkpoints | Get-Member
PS C:\> $Checkpoints | Get-Member | Format-ListDer erste Befehl ruft alle Prüfpunktobjekte auf VMMServer01 ab und speichert die Objekte im $Checkpoints-Objektarray.
Der zweite Befehl übergibt jedes Prüfpunktobjekt in $Checkpoints an das Cmdlet Get-Member , das den .NET TypeName und den Namen, MemberType und Definition für jedes Ereignis, jede Methode und eigenschaft anzeigt, die diesem Objekttyp zugeordnet ist.
Der letzte Befehl entspricht dem zweiten Befehl, mit der Ausnahme, dass er die Ausgabe an das Cmdlet Format-List übergibt, damit Sie die vollständige Definition für jedes Ereignis, jede Methode und eigenschaft für den Prüfpunktobjekttyp sehen können.
Parameter
-ID
Gibt den numerischen Bezeichner als global eindeutigen Bezeichner oder GUID für ein bestimmtes Objekt an.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MostRecent
Gibt das neueste Prüfpunktobjekt für virtuelle VMM-Maschinen an.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Gibt den Namen eines Benutzers an. Dieses Cmdlet legt den Benutzer im Namen des Benutzers als Benutzer fest, 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 |
-VM
Gibt ein Objekt virtueller Maschinen an.
| Type: | VM |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Ausgaben
VMCheckpoint
Dieses Cmdlet gibt ein VMCheckpoint-Objekt zurück.