Freigeben über


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:\> $Checkpoints

Der 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.CheckpointHWProfile

Der 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-List

Der 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.