Remove-SCVMCheckpoint

  • Referência
Módulo:
VirtualMachineManager

Remove um objeto de ponto de verificação da máquina virtual do banco de dados do VMM.

Syntax

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

Description

O cmdlet Remove-SCVMCheckpoint remove um objeto de ponto de verificação de máquina virtual do banco de dados do VMM (Virtual Machine Manager).

Exemplos

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

PS C:\> $Checkpoint = Get-SCVMCheckpoint -VM "VM01" -MostRecent
PS C:\> Remove-SCVMCheckpoint -VMCheckpoint $Checkpoint -Confirm

O primeiro comando obtém todos os objetos de ponto de verificação para VM01 e armazena esses objetos na matriz de objetos $Checkpoints. Este exemplo pressupõe que a VM01 tenha vários pontos de verificação.

O segundo comando remove o primeiro ponto de verificação na matriz ($Checkpoints[0]). O parâmetro Confirm solicita que você confirme se deseja remover o ponto de verificação.

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

PS C:\> $Checkpoints = Get-SCVMCheckpoint -VM "VM01" 
PS C:\> Remove-SCVMCheckpoint -VMCheckpoint $Checkpoints[0] -Confirm

O primeiro comando obtém todos os objetos de ponto de verificação para VM01 e armazena os objetos na matriz de objetos $Checkpoints. Este exemplo pressupõe que a VM01 tenha pelo menos dois pontos de verificação.

O segundo comando remove o primeiro ponto de verificação armazenado na matriz $Checkpoints, que é o primeiro ponto de verificação criado para VM01. O comando solicita a confirmação antes de prosseguir.

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

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho executado.

Type:Guid
Position:Named
Default value:None
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. Esse cmdlet define o nome da função de usuário como a função de usuário especificada por esse parâmetro. Para obter um objeto de função de usuário, use o cmdlet Get-SCUserRole .

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 da máquina virtual do VMM.

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

Observações

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