Partilhar via

Get-ComputerRestorePoint

Módulo:
Microsoft.PowerShell.Management Module

Obtém os pontos de restauração no computador local.

Sintaxe

ID (Predefinição) 

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

LastStatus 

Get-ComputerRestorePoint
    -LastStatus
    [<CommonParameters>]

Description

O cmdlet Get-ComputerRestorePoint obtém os pontos de restauração do sistema do computador local. E pode exibir o status da tentativa mais recente de restaurar o computador.

Você pode usar as informações do Get-ComputerRestorePoint para selecionar um ponto de restauração. Por exemplo, use um número de sequência para identificar um ponto de restauração para o cmdlet Restore-Computer.

Os pontos de restauração do sistema e o cmdlet Get-ComputerRestorePoint são suportados apenas em sistemas operacionais cliente, como Windows 10, Windows 7, Windows Vista e Windows XP.

Exemplos

Exemplo 1: Obter todos os pontos de restauração do sistema

Neste exemplo, Get-ComputerRestorePoint obtém todos os pontos de restauração do sistema do computador 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

Exemplo 2: Obter números de sequência específicos

Este exemplo obtém pontos de restauração do sistema para números de sequência específicos.

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 usa o parâmetro RestorePoint para especificar uma matriz de números de sequência separados por vírgula.

Exemplo 3: Exibir o status de uma restauração do sistema

Este exemplo exibe o status da restauração do sistema mais recente no computador local.

Get-ComputerRestorePoint -LastStatus

The last attempt to restore the computer failed.

Get-ComputerRestorePoint usa o parâmetro LastStatus para exibir o resultado da restauração do sistema mais recente.

Exemplo 4: Usar uma expressão para converter o CreationTime

produz o CreationTime do como uma cadeia de caracteres de data e hora do WMI (Instrumentação de Gerenciamento do Windows).

Neste exemplo, uma variável armazena uma expressão que converte a cadeia de caracteres CreationTime em um objeto DateTime. Para exibir cadeias de caracteres CreationTime antes de serem convertidas, use um comando como ((Get-ComputerRestorePoint).CreationTime). Para obter mais informações sobre a cadeia de caracteres de data e hora WMI, consulte 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

A variável $date armazena uma tabela de hash com a expressão que usa o método ConvertToDateTime. A expressão converte o valor da propriedade CreationTime de uma cadeia de caracteres WMI para um objeto DateTime .

Get-ComputerRestorePoint envia os objetos de ponto de restauração do sistema para baixo do pipeline. Select-Object usa o parâmetro Property para especificar as propriedades a serem exibidas. Para cada objeto no pipeline, a expressão em $date converte o CreationTime e produz o resultado na propriedade Date.

Exemplo 5: Usar uma propriedade para obter um número de sequência

Este exemplo obtém um número de sequência usando a propriedade SequenceNumber e um índice de matriz. A saída contém apenas o número de sequência.

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

6

Get-ComputerRestorePoint usa a propriedade SequenceNumber com um índice de matriz. O índice de matriz de -1 obtém o número de sequência mais recente na matriz.

Parâmetros

-LastStatus

Indica que Get-ComputerRestorePoint obtém o status da operação de restauração do sistema mais recente.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

LastStatus
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RestorePoint

Especifica os números de sequência dos pontos de restauração do sistema. Você pode especificar um único número de sequência ou uma matriz de números de sequência separados por vírgula.

Se o parâmetro RestorePoint não for especificado, Get-ComputerRestorePoint retornará todos os pontos de restauração do sistema do computador local.

Propriedades dos parâmetros

Tipo:

Int32[]

Default value:All restore points
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ID
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Não é possível enviar objetos pelo pipeline para Get-ComputerRestorePoint.

Saídas

ManagementObject

Get-ComputerRestorePoint retorna um objeto SystemRestore, que é uma instância do WMI (Instrumentação de Gerenciamento do Windows) classe SystemRestore.

Quando você usa o parâmetro LastStatus, Get-ComputerRestorePoint retorna uma cadeia de caracteres.

Notas

Para executar um comando Get-ComputerRestorePoint no Windows Vista e versões posteriores do Windows, abra o PowerShell com a opção Executar como administrador opção.

Get-ComputerRestorePoint usa o WMI SystemRestore classe.