Update-SCVMConfiguration
Atualiza as propriedades de um objeto de configuração de máquina virtual do VMM.
Sintaxe
Update-SCVMConfiguration
[-VMConfiguration] <BaseVMConfiguration>
[-ValidateOnly <Boolean>]
[-VMName <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Update-SCVMConfiguration
-VMConfigurationList <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.BaseVMConfiguration]>
[-ValidateOnly <Boolean>]
[-VMName <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Description
O cmdlet Update-SCVMConfiguration atualiza as propriedades de um objeto de configuração de máquina virtual do VMM (Virtual Machine Manager).
Exemplos
Exemplo 1: atualizar uma configuração de máquina virtual existente
PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $VMConfig = Get-SCVMConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> Update-SCVMConfiguration -VMConfiguration $VMConfig[0] -ValidateOnly $True
O primeiro comando obtém o objeto de configuração de serviço chamado Service01 da biblioteca do VMM e armazena o objeto na variável $ServiceConfig.
O segundo comando obtém o objeto de configuração da máquina virtual para a configuração de serviço armazenada em $ServiceConfig e armazena o objeto de configuração da máquina virtual em $VMConfig.
O último comando define a propriedade ValidateOnly como True para o primeiro objeto de configuração armazenado em $VMConfig.
Parâmetros
-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 |
-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 |
-ValidateOnly
Indica se a validação do posicionamento é executada, mas o posicionamento não é realmente executado.
Tipo: | Boolean |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-VMConfiguration
Especifica um objeto de configuração de máquina virtual.
Tipo: | BaseVMConfiguration |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-VMConfigurationList
Especifica uma lista de objetos de configuração.
Tipo: | System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.BaseVMConfiguration] |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-VMName
Especifica o nome de uma máquina virtual a ser colocada em um servidor host físico. Use esse parâmetro para verificar se outra máquina virtual com o mesmo nome ainda não está implantada nesse host.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
Saídas
ComputerConfig
Esse cmdlet retorna um objeto ComputerConfig.
Observações
- Requer um objeto de configuração de máquina virtual do VMM, que pode ser obtido usando o cmdlet Get-SCVMConfiguration.