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 Virtual Machine Manager (VMM).
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"Este 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 de todos os pontos de verificação
PS C:\> Get-SCVMCheckpoint | Set-SCVMCheckpoint -Name "Checkpoint Before Upgrade" -Description "Checkpoint was created prior to upgrade"Este 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 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-JobVariable
Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-Name
Especifica o nome de um objeto do VMM.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OnBehalfOfUser
Especifica o nome de um usuário. Este cmdlet define o em nome do usuário como o usuário especificado por esse parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OnBehalfOfUserRole
Especifica uma função de usuário. Este 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 |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-PROTipID
Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-VMCheckpoint
Especifica um objeto de ponto de verificação de máquina virtual do VMM.
| Tipo: | VMCheckpoint |
| Position: | Named |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
Saídas
VMCheckpoint
Este cmdlet retorna um VMCheckpoint objeto.
Notas
- Requer um objeto de ponto de verificação do VMM, que você pode recuperar usando o cmdlet Get-SCVMCheckpoint.