Restore-SCVMCheckpoint

  • Referência
Módulo:
VirtualMachineManager

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

Syntax

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 checkpoint. 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 aqueles 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 retém os pontos de verificação criados após o ponto de verificação ao 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 em 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 sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMCheckpoint

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

Type:VMCheckpoint
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Saídas

VMCheckpoint

Este 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 .