Partilhar via

Set-SCVMConfiguration

  • Referência
Módulo:
VirtualMachineManager

Modifica a configuração da máquina virtual para uma camada de computador.

Sintaxe

Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   -VMHost <Host>
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-VMHostGroup <HostGroup>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   -Cloud <Cloud>
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVMConfiguration modifica a configuração da máquina virtual para uma camada de computador. A configuração da máquina virtual descreve como a máquina virtual será configurada quando o serviço for implantado.

Exemplos

Exemplo 1: Atualizar a configuração da máquina virtual para uma camada de máquina antes de implantar o serviço

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -Description "This is the updated virtual machine configuration"

O primeiro comando obtém o objeto de configuração de serviço chamado Service01 e armazena o objeto na variável $ServiceConfig.

O segundo comando obtém a configuração da camada de computador para a configuração de serviço armazenada no $ServiceConfig e armazena o objeto na variável $TierConfig.

O terceiro comando obtém a configuração da máquina virtual para a configuração da camada de computador armazenada no $TierConfig e armazena a variável na variável $VMConfig.

O último comando define a propriedade description do primeiro objeto de configuração de máquina virtual armazenado no $VMConfig e exibe as propriedades da configuração da máquina virtual para o usuário.

Exemplo 2: Configurar o objeto de configuração da máquina virtual para uma camada de máquina para fixar o host de uma máquina virtual

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01" 
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -PinVMHost $True

O primeiro comando obtém o objeto de configuração de serviço chamado Service01 e armazena o objeto na variável $ServiceConfig.

O segundo comando obtém o objeto de configuração da camada de computador para a configuração de serviço armazenada no $ServiceConfig e armazena o objeto na variável $TierConfig.

O terceiro comando obtém os objetos de configuração da máquina virtual para a configuração da camada de computador armazenada no $TierConfig e armazena os objetos na variável $VMConfig.

O último comando define a propriedade PinVMHost como $True para o primeiro objeto de configuração de máquina virtual armazenado no $VMConfig. Portanto, quando o serviço é implantado, o host para a máquina virtual criada com essa configuração não será alterado.

Exemplo 3: Configurar o objeto de configuração da máquina virtual para um serviço em uma nuvem privada

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $Cloud = Get-SCCloud -Name "Production"
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[1] -Cloud $Cloud -Description "This is the new virtual machine configuration"

O primeiro comando obtém o objeto de configuração de serviço chamado Service01 e armazena o objeto na variável $ServiceConfig.

O segundo comando obtém a configuração da camada de computador para a configuração de serviço armazenada no $ServiceConfig e armazena o objeto na variável $TierConfig.

O terceiro comando obtém os objetos de configuração da máquina virtual para a configuração da camada de computador armazenada no $TierConfig e armazena os objetos na variável $VMConfig.

O quarto comando obtém o objeto de nuvem privada chamado Production e armazena o objeto na variável $Cloud.

O último comando atualiza a descrição do segundo objeto de configuração da máquina virtual armazenado no $VMConfig para a nuvem privada armazenada no $Cloud.

Parâmetros

-AvailabilitySetNames

Especifica uma lista de nomes de conjuntos de disponibilidade.

Tipo:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CapabilityProfile

Especifica um objeto de perfil de capacidade.

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

-Cloud

Especifica um objeto de nuvem privada.

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

-ComputerName

Especifica o nome de um computador que o Virtual Machine Manager (VMM) pode identificar exclusivamente na rede. Os formatos válidos são:

  • FQDN
  • Endereço IPv4 ou IPv6
  • Nome NetBIOS
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CostCenter

Especifica o centro de custo de uma máquina virtual para que você possa coletar dados sobre a alocação de máquinas virtuais (ou recursos alocados para máquinas virtuais) para usar em seu sistema de cobrança.

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

-Description

Especifica uma descrição para a configuraçã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

-NoConnectedHost

Remove o host de uma configuração de máquina virtual.

Tipo:SwitchParameter
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

-PinVMHost

Indica se o host da máquina virtual escolhido pelo usuário é mantido durante a configuração de implantação do serviço.

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

-PinVMLocation

Indica se o local da máquina virtual escolhido pelo usuário é mantido durante a configuração de implantação do serviço.

Tipo:Boolean
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

-Tag

Especifica uma palavra ou frase a ser associada a um objeto para que você possa pesquisar todos os objetos com o conjunto especificado de tags. Pode procurar um subconjunto de etiquetas ou pode procurar o conjunto completo de etiquetas.

Tipo:String
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

-VMHost

Especifica um objeto de host de máquina virtual. O VMM suporta hosts Hyper-V, VMware ESX e Citrix XenServer.

Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost.

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

-VMHostGroup

Especifica um objeto de grupo de host de máquina virtual ou uma matriz de objetos de grupo de hosts.

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

-VMLocation

Especifica o caminho para uma máquina virtual.

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

-VMMServer

Especifica um objeto de servidor VMM.

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

Saídas

VMConfiguration

Este cmdlet retorna um VMConfiguration objeto.