Partilhar via

Restore-SCVMCheckpoint

  • Referência
Módulo:
VirtualMachineManager

Restaura uma máquina virtual para um ponto de verificação especificado.

Sintaxe

Restore-SCVMCheckpoint
       -VMCheckpoint <VMCheckpoint>
       [-RunAsynchronously]
       [-PROTipID <Guid>]
       [-JobVariable <String>]
       [-WhatIf]
       [-Confirm]
       [-OnBehalfOfUser <String>]
       [-OnBehalfOfUserRole <UserRole>]
       [<CommonParameters>]

Description

O cmdlet Restore-SCVMCheckpoint restaura uma máquina virtual para um ponto de verificação especificado. Um ponto de verificação de máquina virtual é um "instantâneo" point-in-time de uma máquina virtual. Você pode usar o ponto de verificação para reverter uma máquina virtual para um estado anterior.

Se a operação de restauração for bem-sucedida, o cmdlet Restore-VMCheckpoint retornará o objeto de ponto de verificação. Se a operação falhar, o cmdlet retornará uma mensagem de erro.

A restauração de uma máquina virtual para um ponto de verificação anterior descarta todas as alterações feitas na máquina virtual desde que o ponto de verificação mais recente foi criado. No entanto, todos os pontos de verificação, incluindo aqueles feitos após o ponto de verificação para o qual você restaura uma máquina virtual, permanecem disponíveis. Portanto, uma boa prática é criar um novo ponto de verificação antes de restaurar a máquina virtual para garantir que o estado atual da máquina virtual esteja disponível após a operação de restauração.

Exemplos

Exemplo 1: Restaurar uma máquina virtual para seu ponto de verificação mais recente

PS C:\> Get-SCVMCheckpoint -VM "VM01" -MostRecent | Restore-SCVMCheckpoint

Este comando obtém o objeto de ponto de verificação mais recente para a máquina virtual VM01 e restaura o VM01 para o estado em que estava no momento em que seu ponto de verificação mais recente foi criado.

Exemplo 2: Restaurar uma máquina virtual para o ponto de verificação especificado

PS C:\> $Checkpoints = Get-SCVMCheckpoint -VM "VM02"
PS C:\> Restore-SCVMCheckpoint -VMCheckpoint $Checkpoints[$Checkpoints.count - 2]

O primeiro comando obtém todos os objetos de ponto de verificação para a máquina virtual VM02 e armazena os objetos na matriz de objetos $Checkpoints.

O segundo comando restaura o VM02 para o penúltimo ponto de verificação (este exemplo pressupõe que você tenha pelo menos dois pontos de verificação). O VMM retém os pontos de verificação criados após o ponto de verificação para o qual você restaura, permitindo que você restaure a máquina virtual para um ponto de verificação posterior. Para restaurar uma máquina virtual para seu ponto de verificação mais recente, consulte o Exemplo 1.

Exemplo 3: Exibir o perfil de hardware do último ponto de verificação restaurado em uma máquina virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $VM.LastRestoredVMCheckpoint.CheckpointHWProfile

O primeiro comando obtém o objeto de máquina virtual chamado VM02 e armazena o objeto na variável $VM. Este exemplo pressupõe que a máquina virtual foi restaurada para um de seus pontos de verificação.

O segundo comando exibe informações sobre o perfil de hardware do último ponto de verificação restaurado no VM02.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUser

Especifica o nome de um usuário. Este cmdlet define o em nome do usuário como o usuário especificado por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMCheckpoint

Especifica um objeto de ponto de verificação de máquina virtual do Virtual Machine Manager (VMM).

Tipo:VMCheckpoint
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

VMCheckpoint

Este cmdlet retorna um VMCheckpoint objeto.

Notas

  • Requer um objeto de ponto de verificação do VMM, que você pode recuperar usando o cmdlet Get-SCVMCheckpoint.