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 Get-ComputerRestorePoint Cmdlet 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 Get-ComputerRestorePoint verwenden, um einen Wiederherstellungspunkt auszuwählen. Verwenden Sie beispielsweise eine Sequenznummer, um einen Wiederherstellungspunkt für das Restore-Computer Cmdlet zu identifizieren.

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

Beispiele

Beispiel 1: Abrufen aller Systemwiederherstellungspunkte

Ruft in diesem Beispiel 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 RestorePoint-Parameter , 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 (CreationTime ) 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)z. B. . 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 Systemwiederherstellungspunktobjekte nach unten in der Pipeline. Select-Object verwendet den Property-Parameter , um die anzuzeigenden Eigenschaften anzugeben. Für jedes Objekt in der Pipeline konvertiert der Ausdruck $date die CreationTime und gibt das Ergebnis in der Date-Eigenschaftaus.

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 der Status des letzten Systemwiederherstellungsvorgangs abgerufen wird.

Type:SwitchParameter
Position:Named
Default value:False
Required:True
Accept pipeline input:False
Accept wildcard characters: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 RestorePoint-Parameter nicht angegeben ist, Get-ComputerRestorePoint werden alle Systemwiederherstellungspunkte des lokalen Computers zurückgegeben.

Type:Int32[]
Position:0
Default value:All restore points
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Objekte können nicht an die Pipeline gesendet werden.Get-ComputerRestorePoint

Ausgaben

ManagementObject

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

Wenn Sie den Parameter LastStatus verwenden, Get-ComputerRestorePoint wird eine Zeichenfolge zurückgegeben.

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 .