Set-SCVMCheckpoint
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 .