Set-SCVMCheckpoint

  • Referência
Módulo:
VirtualMachineManager

Modifica as propriedades de um objeto de ponto de verificação de máquina virtual no VMM.

Syntax

Set-SCVMCheckpoint
   -VMCheckpoint <VMCheckpoint>
   [-Description <String>]
   [-Name <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVMCheckpoint modifica as propriedades de um objeto de ponto de verificação de máquina virtual no VMM (Virtual Machine Manager).

Para obter informações sobre como criar pontos de verificação do VMM, digite Get-Help New-SCVMCheckpoint -Detailed.

Exemplos

Exemplo 1: definir a descrição de todos os pontos de verificação para uma cadeia de caracteres especificada

PS C:\> Get-SCVMCheckpoint | Set-SCVMCheckpoint -Description "All checkpoints created prior to upgrade"

Esse comando obtém todos os objetos de ponto de verificação existentes do banco de dados do VMM e atualiza a descrição desses pontos de verificação.

Exemplo 2: modificar o nome e a descrição para todos os pontos de verificação

PS C:\> Get-SCVMCheckpoint | Set-SCVMCheckpoint -Name "Checkpoint Before Upgrade" -Description "Checkpoint was created prior to upgrade"

Esse comando obtém todos os objetos de ponto de verificação existentes e modifica o nome e a descrição de cada objeto.

Exemplo 3: modificar um ponto de verificação específico em uma matriz de pontos de verificação

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> Set-SCVMCheckpoint -VMCheckpoint $VM.VMCheckpoints[0] -Description "First Checkpoint Before Upgrade"

O primeiro comando obtém o objeto de máquina virtual chamado VM03 e armazena o objeto na variável $VM.

O último comando modifica a descrição do primeiro objeto de ponto de verificação na matriz VMCheckpoints para VM03.

Parâmetros

-Description

Especifica uma descrição para um ponto de verificação.

Type:String
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

-Name

Especifica o nome de um objeto do VMM.

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 a função em nome do 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 de máquina virtual do VMM.

Type:VMCheckpoint
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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 .