Compartilhar 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 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 de 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 propety PinVMHost como $True para o primeiro objeto de configuração de máquina virtual armazenado em $VMConfig. Portanto, quando o serviço é 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.

Tipo:System.Collections.Generic.List`1[System.String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CapabilityProfile

Especifica um objeto de perfil de funcionalidade.

Tipo:CapabilityProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Cloud

Especifica um objeto de nuvem privada.

Tipo:Cloud
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 do NetBIOS
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 fazer uso em seu sistema de cobrança.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-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

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NoConnectedHost

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

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

-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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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
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

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

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

-VMHost

Especifica um objeto de 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.

Tipo:Host
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMHostGroup

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

Tipo:HostGroup
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMLocation

Especifica o caminho para uma máquina virtual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

VMConfiguration

Esse cmdlet retorna um objeto VMConfiguration .