Get-ComputerRestorePoint
Obtém os pontos de restauração no computador local.
Sintaxe
ID (Default)
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. Além disso, ele pode exibir o status da tentativa mais recente de restaurar o computador.
Você pode usar as informações de 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 têm suporte 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 separada por vírgulas de números de sequência.
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 mais recente do sistema.
Exemplo 4: usar uma expressão para converter o CreationTime
Get-ComputerRestorePoint gera o CreationTime como uma cadeia de caracteres de data e hora da Instrumentação de Gerenciamento do Windows (WMI).
Neste exemplo, uma variável armazena uma expressão que converte a cadeia de caracteres ((Get-ComputerRestorePoint).CreationTime). Para obter mais informações sobre a cadeia de caracteres de data e hora do 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
Get-ComputerRestorePoint envia os objetos do ponto de restauração do sistema pelo 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 gera 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 do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
LastStatus
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 separada por vírgulas de números de sequência.
Se o parâmetro RestorePoint não for especificado, Get-ComputerRestorePoint retornará todos os pontos de restauração do sistema do computador local.
Propriedades do parâmetro
| Tipo: | Int32[] |
| Valor padrão: | All restore points |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ID
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 da classe SystemRestore da Instrumentação de Gerenciamento do Windows (WMI).
Quando você usa o parâmetro
Observações
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.