Compartilhar 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" pontual 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.

Restaurar uma máquina virtual em 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 os feitos após o ponto de verificação no 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

Esse comando obtém o objeto de ponto de verificação mais recente da VM01 da máquina virtual e restaura a 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 da VM02 da máquina virtual e armazena os objetos na matriz de objetos $Checkpoints.

O segundo comando restaura a VM02 para o segundo ponto de verificação do último ponto de verificação (este exemplo pressupõe que você tenha pelo menos dois pontos de verificação). O VMM manté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 na VM02.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUser

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUserRole

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

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMCheckpoint

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

Tipo:VMCheckpoint
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

VMCheckpoint

Esse cmdlet retorna um objeto VMCheckpoint.

Observações

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