Update-SCVMConfiguration

  • Referência
Módulo:
VirtualMachineManager

Atualizações as propriedades de um objeto de configuração de máquina virtual do VMM.

Syntax

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 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

-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 o nome da função de 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

-ValidateOnly

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConfiguration

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

Type:BaseVMConfiguration
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMConfigurationList

Especifica uma lista de objetos de configuração.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.BaseVMConfiguration]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .