Freigeben über

Get-ComputerRestorePoint

  • Referenz
Modul:
Microsoft.PowerShell.Management

Ruft die Wiederherstellungspunkte auf dem lokalen Computer ab.

Syntax

Get-ComputerRestorePoint
   [[-RestorePoint] <Int32[]>]
   [<CommonParameters>]
Get-ComputerRestorePoint
   -LastStatus
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-ComputerRestorePoint ruft die Systemwiederherstellungspunkte des lokalen Computers ab. Außerdem kann der Status des letzten Versuchs zum Wiederherstellen des Computers angezeigt werden.

Sie können die Informationen aus Get-ComputerRestorePoint verwenden, um einen Wiederherstellungspunkt auszuwählen. Verwenden Sie beispielsweise eine Sequenznummer, um einen Wiederherstellungspunkt für das Cmdlet Restore-Computer zu identifizieren.

Systemwiederherstellungspunkte und das Cmdlet Get-ComputerRestorePoint werden nur auf Clientbetriebssystemen wie Windows 10 unterstützt.

Beispiele

Beispiel 1: Abrufen aller Systemwiederherstellungspunkte

In diesem Beispiel ruft Get-ComputerRestorePoint alle Systemwiederherstellungspunkte des lokalen Computers ab.

Get-ComputerRestorePoint

CreationTime           Description                    SequenceNumber    EventType         RestorePointType
------------           -----------                    --------------    ---------         ----------------
7/30/2019 09:17:24     Windows Update                 4                 BEGIN_SYSTEM_C... 17
8/5/2019  08:15:37     Installed PowerShell 7-prev... 5                 BEGIN_SYSTEM_C... APPLICATION_INSTALL
8/7/2019  12:56:45     Installed PowerShell 6-x64     6                 BEGIN_SYSTEM_C... APPLICATION_INSTALL

Beispiel 2: Abrufen bestimmter Sequenznummern

In diesem Beispiel werden Systemwiederherstellungspunkte für bestimmte Sequenznummern angezeigt.

Get-ComputerRestorePoint -RestorePoint 4, 5

CreationTime           Description                    SequenceNumber    EventType         RestorePointType
------------           -----------                    --------------    ---------         ----------------
7/30/2019 09:17:24     Windows Update                 4                 BEGIN_SYSTEM_C... 17
8/5/2019  08:15:37     Installed PowerShell 7-prev... 5                 BEGIN_SYSTEM_C... APPLICATION_INSTALL

Get-ComputerRestorePoint verwendet den Parameter RestorePoint, um ein durch Trennzeichen getrenntes Array von Sequenznummern anzugeben.

Beispiel 3: Anzeigen des Status einer Systemwiederherstellung

In diesem Beispiel wird der Status der neuesten Systemwiederherstellung auf dem lokalen Computer angezeigt.

Get-ComputerRestorePoint -LastStatus

The last attempt to restore the computer failed.

Get-ComputerRestorePoint verwendet den Parameter LastStatus, um das Ergebnis der letzten Systemwiederherstellung anzuzeigen.

Beispiel 4: Verwenden eines Ausdrucks zum Konvertieren der CreationTime

Get-ComputerRestorePoint gibt die CreationTime- als WMI-Datums- und Uhrzeitzeichenfolge (Windows Management Instrumentation) aus.

In diesem Beispiel speichert eine Variable einen Ausdruck, der die CreationTime- Zeichenfolge in ein DateTime--Objekt konvertiert. Um CreationTime- Zeichenfolgen anzuzeigen, bevor sie konvertiert werden, verwenden Sie einen Befehl wie ((Get-ComputerRestorePoint).CreationTime). Weitere Informationen zur WMI-Datums- und Uhrzeitzeichenfolge finden Sie unter CIM_DATETIME.

$date = @{Label="Date"; Expression={$_.ConvertToDateTime($_.CreationTime)}}
Get-ComputerRestorePoint | Select-Object -Property SequenceNumber, $date, Description

SequenceNumber   Date                 Description
--------------   ----                 -----------
             4   7/30/2019 09:17:24   Windows Update
             5   8/5/2019  08:15:37   Installed PowerShell 7-preview-x64
             6   8/7/2019  12:56:45   Installed PowerShell 6-x64

Die $date Variable speichert eine Hashtabelle mit dem Ausdruck, der die ConvertToDateTime--Methode verwendet. Der Ausdruck konvertiert den Wert der CreationTime-Eigenschaft aus einer WMI-Zeichenfolge in ein DateTime--Objekt.

Get-ComputerRestorePoint sendet die Objekte des Systemwiederherstellungspunkts an die Pipeline. Select-Object verwendet den Parameter Property, um die anzuzeigenden Eigenschaften anzugeben. Für jedes Objekt in der Pipeline konvertiert der Ausdruck in $date die CreationTime- und gibt das Ergebnis in der eigenschaft Date aus.

Beispiel 5: Verwenden einer Eigenschaft zum Abrufen einer Sequenznummer

In diesem Beispiel wird eine Sequenznummer mithilfe der SequenceNumber-Eigenschaft und eines Arrayindex abgerufen. Die Ausgabe enthält nur die Sequenznummer.

((Get-ComputerRestorePoint).SequenceNumber)[-1]

6

Get-ComputerRestorePoint verwendet die SequenceNumber-Eigenschaft mit einem Arrayindex. Der Arrayindex von -1 ruft die letzte Sequenznummer im Array ab.

Parameter

-LastStatus

Gibt an, dass Get-ComputerRestorePoint den Status des letzten Systemwiederherstellungsvorgangs abruft.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RestorePoint

Gibt die Sequenznummern der Systemwiederherstellungspunkte an. Sie können entweder eine einzelne Sequenznummer oder ein durch Trennzeichen getrenntes Array von Sequenznummern angeben.

Wenn der parameter RestorePoint nicht angegeben ist, gibt Get-ComputerRestorePoint alle Systemwiederherstellungspunkte des lokalen Computers zurück.

Typ:Int32[]
Position:0
Standardwert:All restore points
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Objekte können nicht an Get-ComputerRestorePointgesendet werden.

Ausgaben

ManagementObject

Get-ComputerRestorePoint gibt ein SystemRestore--Objekt zurück, bei dem es sich um eine Instanz der Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) SystemRestore Klasse handelt.

Wenn Sie den parameter LastStatus verwenden, gibt Get-ComputerRestorePoint eine Zeichenfolge zurück.

Hinweise

Um einen Get-ComputerRestorePoint Befehl unter Windows Vista und höheren Versionen von Windows auszuführen, öffnen Sie PowerShell mit der Option Als Administrator ausführen.

Get-ComputerRestorePoint verwendet die WMI-SystemRestore- Klasse.