Compartilhar via


Set-SCVMConfiguration

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

Syntax

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 em $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 em $TierConfig e armazena a variável na variável $VMConfig.

O último comando define a propriedade de descrição do primeiro objeto de configuração de máquina virtual armazenado em $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 para 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 em $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 em $TierConfig e armazena os objetos na variável $VMConfig.

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

Exemplo 3: configurar o objeto de configuração de 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 em $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 em $TierConfig e armazena os objetos na variável $VMConfig.

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

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

Parâmetros

-AvailabilitySetNames

Especifica uma lista de nomes de conjunto de disponibilidade.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CapabilityProfile

Especifica um objeto de perfil de funcionalidade.

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

-Cloud

Especifica um objeto de nuvem privada.

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

-ComputerName

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

  • FQDN
  • Endereço IPv4 ou IPv6
  • Nome NetBIOS
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Description

Especifica uma descrição para a configuração.

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

-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

-Name

Especifica o nome de um objeto do VMM.

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

-NoConnectedHost

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

Type:SwitchParameter
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 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 .

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

-PinVMHost

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

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

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

-Tag

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

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

-VMHost

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

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

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

-VMHostGroup

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

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

-VMLocation

Especifica o caminho para uma máquina virtual.

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

-VMMServer

Especifica um objeto de servidor do VMM.

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

Saídas

VMConfiguration

Esse cmdlet retorna um objeto VMConfiguration .