Partager via

Get-ComputerRestorePoint

  • Référence
Module:
Microsoft.PowerShell.Management

Obtient les points de restauration présents sur l'ordinateur local.

Syntaxe

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

Description

L’applet Get-ComputerRestorePoint de commande obtient les points de restauration système de l’ordinateur local. Il peut également afficher l’état de la tentative la plus récente de restaurer l’ordinateur.

Vous pouvez utiliser les informations à partir de Get-ComputerRestorePoint laquelle sélectionner un point de restauration. Par exemple, utilisez un numéro de séquence pour identifier un point de restauration pour l’applet de Restore-Computer commande.

Les points de restauration système et l’applet Get-ComputerRestorePoint de commande sont pris en charge uniquement sur les systèmes d’exploitation clients tels que Windows 10.

Exemples

Exemple 1 : Obtenir tous les points de restauration système

Dans cet exemple, Get-ComputerRestorePoint obtient tous les points de restauration système de l’ordinateur local.

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

Exemple 2 : Obtenir des numéros de séquence spécifiques

Cet exemple obtient des points de restauration système pour des nombres de séquences spécifiques.

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 utilise le paramètre RestorePoint pour spécifier un tableau séparé par des virgules de nombres de séquences.

Exemple 3 : Afficher l’état d’une restauration du système

Cet exemple montre comment afficher l’état de la restauration système la plus récente sur l’ordinateur local.

Get-ComputerRestorePoint -LastStatus

The last attempt to restore the computer failed.

Get-ComputerRestorePoint utilise le paramètre LastStatus pour afficher le résultat de la restauration système la plus récente.

Exemple 4 : Utiliser une expression pour convertir CreationTime

Get-ComputerRestorePoint génère la valeur CreationTime en tant que chaîne de date et d’heure WMI (Windows Management Instrumentation).

Dans cet exemple, une variable stocke une expression qui convertit la chaîne CreationTime en objet DateTime. Pour afficher les chaînes CreationTime avant qu’elles ne soient converties, utilisez une commande telle que ((Get-ComputerRestorePoint).CreationTime). Pour plus d’informations sur la chaîne de date et d’heure WMI, consultez 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

La $date variable stocke une table de hachage avec l’expression qui utilise la méthode ConvertToDateTime . L’expression convertit la valeur de la propriété CreationTime d’une chaîne WMI en objet DateTime .

Get-ComputerRestorePoint envoie les objets du point de restauration système vers le bas du pipeline. Select-Object utilise le paramètre Property pour spécifier les propriétés à afficher. Pour chaque objet du pipeline, l’expression en cours $date convertit CreationTime et génère le résultat dans la propriété Date.

Exemple 5 : Utiliser une propriété pour obtenir un numéro de séquence

Cet exemple obtient un numéro de séquence à l’aide de la propriété SequenceNumber et d’un index de tableau. La sortie contient uniquement le numéro de séquence.

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

6

Get-ComputerRestorePoint utilise la propriété SequenceNumber avec un index de tableau. L’index de tableau d’obtient -1 le numéro de séquence le plus récent dans le tableau.

Paramètres

-LastStatus

Indique qu’il Get-ComputerRestorePoint obtient l’état de l’opération de restauration système la plus récente.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RestorePoint

Spécifie les numéros de séquence des points de restauration système. Vous pouvez spécifier un numéro de séquence unique ou un tableau séparé par des virgules de nombres de séquences.

Si le paramètre RestorePoint n’est pas spécifié, Get-ComputerRestorePoint retourne tous les points de restauration système de l’ordinateur local.

Type:Int32[]
Position:0
Valeur par défaut:All restore points
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Vous ne pouvez pas envoyer d’objets vers le pipeline .Get-ComputerRestorePoint

Sorties

ManagementObject

Get-ComputerRestorePointretourne un objet SystemRestore, qui est une instance de la classe SystemRestore Windows Management Instrumentation (WMI).

Lorsque vous utilisez le paramètre LastStatus , Get-ComputerRestorePoint retourne une chaîne.

Notes

Pour exécuter une Get-ComputerRestorePoint commande sur Windows Vista et les versions ultérieures de Windows, ouvrez PowerShell avec l’option Exécuter en tant qu’administrateur .

Get-ComputerRestorePoint utilise la classe WMI SystemRestore .