Set-SCVMCheckpoint
Modifica as propriedades de um objeto de ponto de verificação de máquina virtual no VMM.
Sintaxe
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.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| 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 |
-Name
Especifica o nome de um objeto do VMM.
| 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. 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.
| 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.
| Tipo: | VMCheckpoint |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| 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
.