Partager via

Get-ComputerRestorePoint

Module:
Microsoft.PowerShell.Management Module

Obtient les points de restauration sur l’ordinateur local.

Syntaxe

ID (Par défaut) 

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

LastStatus 

Get-ComputerRestorePoint
    -LastStatus
    [<CommonParameters>]

Description

L’applet de commande Get-ComputerRestorePoint 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 de Get-ComputerRestorePoint pour 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 commande Restore-Computer.

Les points de restauration système et l’applet de commande Get-ComputerRestorePoint 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 numéros de séquence.

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.

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

génère l' 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 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 variable $date 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 de point de restauration système vers le bas du pipeline. utilise le paramètre Property pour spécifier les propriétés à afficher. Pour chaque objet du pipeline, l’expression dans $date convertit l'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 de -1 obtient le numéro de séquence le plus récent dans le tableau.

Paramètres

-LastStatus

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

LastStatus
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

Int32[]

Valeur par défaut:All restore points
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ID
Position:0
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

None

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

Sorties

ManagementObject

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

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

Notes

Pour exécuter une commande Get-ComputerRestorePoint 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.