Partilhar via


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 Virtual Machine Manager (VMM).

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 no $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 no $VMConfig.

Parâmetros

-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

-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

-ValidateOnly

Indica se a validação do posicionamento é executada, mas o posicionamento não é realmente executado.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMConfiguration

Especifica um objeto de configuração de máquina virtual.

Tipo:BaseVMConfiguration
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VMConfigurationList

Especifica uma lista de objetos de configuração.

Tipo:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.BaseVMConfiguration]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

ComputerConfig

Este cmdlet retorna um objeto ComputerConfig.

Notas

  • Requer um objeto de configuração de máquina virtual do VMM, que pode ser obtido usando o cmdlet Get-SCVMConfiguration.