Set-SCVirtualMachine

Referência

Módulo:: VirtualMachineManager

Altera as propriedades de uma máquina virtual gerenciada pelo VMM.

Sintaxe

Set-SCVirtualMachine
   [-VM] <VM>
   [-VMwareResourcePool <VmwResourcePool>]
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-RemoveSelfServiceUserRole <Boolean>]
   [-EnableOperatingSystemShutdown <Boolean>]
   [-EnableTimeSync <Boolean>]
   [-EnableDataExchange <Boolean>]
   [-EnableHeartbeat <Boolean>]
   [-EnableBackup <Boolean>]
   [-InstallVirtualizationGuestServices <Boolean>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled <Boolean>]
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-VMShieldingData <KeyFile>]
   [-RunAsSystem]
   [-RunAsUserCredential <PSCredential>]
   [-DelayStartSeconds <Int32>]
   [-UseHardwareAssistedVirtualization <Boolean>]
   [-Cloud <Cloud>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-RemoveFromCloud]
   [-ClusterNonPossibleOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-ClusterPreferredOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-UserRole <UserRole>]
   [-Name <String>]
   [-JobGroup <Guid>]
   [-QuotaPoint <UInt32>]
   [-CostCenter <String>]
   [-Tag <String>]
   [-Custom1 <String>]
   [-Custom2 <String>]
   [-Custom3 <String>]
   [-Custom4 <String>]
   [-Custom5 <String>]
   [-Custom6 <String>]
   [-Custom7 <String>]
   [-Custom8 <String>]
   [-Custom9 <String>]
   [-Custom10 <String>]
   [-BlockDynamicOptimization <Boolean>]
   [-ClearDRProtection]
   [-Description <String>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled <Boolean>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled <Boolean>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-RecoveryPointObjective <Int32>]
   [-ProtectionProvider <ProtectionProvider>]
   [-BootOrder <BootDevice[]>]
   [-FirstBootDevice <String>]
   [-SecureBootTemplate <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPUExpectedUtilizationPercent <Int32>]
   [-DiskIops <Int32>]
   [-NetworkUtilizationMbps <Int32>]
   [-CPURelativeWeight <Int32>]
   [-CPUReserve <Int32>]
   [-CPUMaximumPercent <Int32>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired <Boolean>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVirtualMachine altera as propriedades de uma máquina virtual gerenciada pelo Virtual Machine Manager (VMM).

As propriedades que você pode alterar incluem o seguinte:

Associe uma máquina virtual a uma nuvem.
Nome, proprietário e descrição de uma máquina virtual.
Ordem de inicialização do BIOS, se a máquina virtual for implantada em um host Hyper-V.
Quantidade de recursos no host usado por uma máquina virtual. Estes incluem o seguinte:
Quantidade máxima de recursos da CPU do host que uma máquina virtual pode usar.
Uso esperado da CPU do host por uma máquina virtual.
Quantidade de recursos de CPU do host usados por uma máquina virtual em relação a outras máquinas virtuais no mesmo host.
Quantidade de memória de host que uma máquina virtual pode usar.
Quantidade de largura de banda na rede do host que uma máquina virtual pode usar.
Configurações de hardware para uma máquina virtual não relacionadas aos recursos do host. Estes incluem o seguinte:
Número de CPUs.
Tipo de CPU.
Número de operações de entrada/saída de disco por segundo (IOPS).
Limitando a funcionalidade da CPU, para um sistema operacional mais antigo, como o Windows NT 4.0.
Centro de custo, tag e configurações personalizadas que são usadas para filtrar máquinas virtuais por critérios.
Configurações que habilitam vários recursos opcionais, que incluem o seguinte:
Habilitar ou desabilitar um objeto de biblioteca para torná-lo disponível, ou temporariamente indisponível, para os usuários.
Habilitando o backup de uma máquina virtual em um host Hyper-V com o serviço de Cópias de Sombra de Volume.
Habilitando um par chave/valor para troca de dados entre uma máquina virtual e seu host Hyper-V.
Habilitando o desligamento de uma máquina virtual do console Hyper-V.
Habilitando a sincronização de tempo entre uma máquina virtual e seu host Hyper-V.
Ativando o valor do BIOS para NumLock para uma máquina virtual em um host Hyper-V.
Configuração que identifica se uma máquina virtual está altamente disponível, ou seja, uma máquina virtual a ser implantada em um nó de um cluster de host Hyper-V ou de um cluster de host Citrix XenServer.
Configuração que determina se os serviços de convidado de virtualização são instalados em uma máquina virtual implantada em um host Hyper-V.
Número de segundos a atrasar antes de iniciar uma máquina virtual.
Configuração que identifica o sistema operacional usado para uma máquina virtual.
Inicie e pare ações para uma máquina virtual.
Configuração que limita o número de máquinas virtuais que os usuários de autoatendimento podem criar.
Configuração usada para alternar a função que um usuário de autoatendimento que pertence a várias funções usa para gerenciar uma máquina virtual.
Configuração que atribui uma máquina virtual em um host ESX a um pool de recursos VMware.

Se desejar alterar as propriedades de uma unidade de disquete virtual, unidade de DVD virtual, adaptador de rede virtual ou adaptador SCSI virtual associado a uma máquina virtual específica, use o Set-SCVirtualFloppyDrive, Set-SCVirtualDVDDrive, Set-SCVirtualNetworkAdapterou cmdlet Set-SCVirtualScsiAdapter.

Exemplos

Exemplo 1: Especificar uma quantidade de memória para uma máquina virtual existente

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> If($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -MemoryMB 1024

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e, em seguida, armazena esse objeto na variável $VM.

O segundo determina se a máquina virtual armazenada no $VM está em um estado desligado. Se a máquina virtual não estiver em um estado desligado, o comando usará o comando Stop-SCVirtualMachine para desligar a máquina virtual. Para obter mais informações sobre como desligar uma máquina virtual, digite Get-Help Stop-SCVirtualMachine.

O último comando altera a memória alocada para VM01 para 1024 MB.

Exemplo 2: Alterar a função de usuário usada para gerenciar uma máquina virtual para um usuário que pertence a várias funções de usuário de autoatendimento

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" -Name "VM02"
PS C:\> $SSRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCVirtualMachine -VM $VM -UserRole $SSRole

O primeiro comando obtém o objeto de máquina virtual chamado VM02 do VMMServer01 e, em seguida, armazena esse objeto na variável $VM.

O segundo comando obtém o objeto de função de usuário chamado ContosoSelfServiceUsers e armazena o objeto na variável $SSRole.

O último comando especifica que os membros da função de usuário de autoatendimento chamada SSUserRole3 agora recebem a permissão para gerenciar a máquina virtual chamada VM02.

Observação: o VMM usa o parâmetro UserRole para definir quais máquinas virtuais são gerenciadas pelos membros de uma função de usuário de autoatendimento específica. Normalmente, não é necessário usar o cmdlet Set-SCVirtualMachine com o parâmetro UserRole para definir essa configuração. No entanto, se um ou mais usuários forem membros de várias funções de usuário de autoatendimento e você conceder permissão a eles para gerenciar várias máquinas virtuais no mesmo host, poderá encontrar um caso em que deseja alternar qual função de usuário está autorizada a gerenciar uma máquina virtual específica. Este exemplo ilustra esse cenário.

Exemplo 3: Desativar a sincronização de tempo em uma máquina virtual usada como controlador de domínio

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "STOP"
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> trap{"Fail: Cannot disable Time Synchronization for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -EnableTimeSynchronization $TRUE | Out-Null
PS C:\> $ErrorActionPreference = $EAP

O primeiro comando armazena a configuração atual para $ErrorActionPreference na variável $EAP. Essa variável é usada posteriormente para retornar a configuração ao seu valor original.

O segundo comando define a preferência de ação como STOP. Essa preferência de ação de erro altera um erro de um erro de não terminação para um erro de encerramento. O objeto de erro é gerado como uma exceção em vez de ser gravado no pipe de saída e o comando não continua a ser executado.

O terceiro comando obtém o objeto de máquina virtual chamado VM03 e armazena esse objeto na variável $VM.

O quarto comando desativa a configuração de sincronização de tempo. Normalmente, a desativação da sincronização de tempo é necessária para máquinas virtuais que atuam como controladores de domínio. O comando usa a instrução trap para capturar exceções de encerramento. Se o comando Set-SCVirtualMachine falhar, a cadeia de caracteres na instrução trap será exibida. Continue é usado na instrução trap para continuar a execução em vez de sair. O cmdlet Out-Null redireciona a saída para $Null em vez de enviá-la para o console.

O último comando define o valor de $ErrorActionPreference para o valor armazenado em $EAP.

Exemplo 4: Definir a ordem de início do dispositivo para todas as máquinas virtuais que suportam este recurso

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "Stop"
PS C:\> $VMs = @(Get-SCVirtualMachine)
PS C:\> ForEach($VM in $VMs){trap{"Fail: Cannot set BIOS for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -BootOrder "PXEBoot","IDEHarddrive","CD","Floppy" | Out-Null}
PS C:\> $ErrorActionPreference = $EAP

O primeiro comando armazena a configuração atual para $ErrorActionPreference no $EAP. Essa variável é usada posteriormente para retornar a configuração ao seu valor original.

O segundo comando define a preferência de ação de erro como Parar. Essa preferência de ação de erro altera um erro de um erro de não terminação para um erro de encerramento. O objeto de erro é gerado como uma exceção em vez de ser gravado no pipe de saída e o comando não continua a ser executado.

O terceiro comando obtém que cada objeto de máquina virtual armazena os objetos em $VMs. Usar o símbolo @ e parênteses garante que o comando armazene os resultados em uma matriz, caso o comando retorne um único objeto ou um valor nulo.

O quarto comando define a ordem de inicialização do BIOS para cada máquina virtual como PXEBoot,IDEHarddrive,CD,Floppy. O comando usa uma instrução trap para capturar exceções de encerramento. Se o comando Set-SCVirtualMachine falhar, a cadeia de caracteres na instrução trap será exibida. Continue é usado na instrução trap para continuar a execução em vez de sair do loop de ForEach do . O cmdlet Out-Null redireciona a saída para $Null em vez de enviá-la para o console.

Nota: O parâmetro BootOrder é usado apenas para máquinas virtuais em hosts Hyper-V e Citrix XenServer. Ele não é usado para máquinas virtuais em hosts VMware ESX. Os hosts XenServer não suportam disquetes e, portanto, ignoram o Disquete se listados na ordem de inicialização.

O último comando define o valor de $ErrorActionPreference para o valor armazenado no EAP.

Para obter mais informações sobre a instrução de loop padrão do Windows PowerShellForEach, digite Get-Help about_ForEach.

Exemplo 5: Especificar um proprietário para todas as máquinas virtuais sem um proprietário

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq ""} | Set-SCVirtualMachine -Owner "Contoso\ReneeLo"

Este comando obtém todos os objetos de máquina virtual no VMMServer01, seleciona apenas os objetos de máquina virtual em que nenhum proprietário está listado e especifica um proprietário para cada máquina virtual.

Exemplo 6: Habilitar memória dinâmica para uma máquina virtual existente

PS C:\> $VM = Get-SCVirtualMachine -Name "VM06"
PS C:\> if($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

O primeiro comando obtém o objeto de máquina virtual VM06 e armazena esse objeto na variável $VM. Para habilitar a memória dinâmica em uma máquina virtual, a máquina virtual deve residir em um host que execute o Windows Server 2008 R2 SP1 ou uma versão posterior.

O segundo comando determina se a máquina virtual armazenada no $VM está em um estado desligado. Se a máquina virtual não estiver em um estado desligado, o comando usará o comando Stop-SCVirtualMachine para desligar a máquina virtual.

O último comando habilita a memória dinâmica, define a memória de inicialização como 1024 MB e define a memória máxima como 2048 MB. A memória de inicialização é a quantidade de memória no host alocada para VM06 na inicialização. A memória máxima é a quantidade máxima de memória no host alocada para VM06.

Parâmetros

-AutomaticCriticalErrorAction

Especifica a ação a ser tomada quando a máquina virtual encontra um erro crítico e excede a duração do tempo limite especificada pelo parâmetro AutomaticCriticalErrorActionTimeout. Os valores aceitáveis para este parâmetro são: Pause e None.

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

-AutomaticCriticalErrorActionTimeout

Especifica a quantidade de tempo, em minutos, para aguardar em pausa crítica antes de desligar a máquina virtual.

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

-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

-BlockDynamicOptimization

Indica se a otimização dinâmica está bloqueada para uma máquina virtual.

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

-BootOrder

Especifica a ordem, como uma matriz, de dispositivos que uma máquina virtual em um host Hyper-V usa para iniciar. Os valores válidos são:

Álbum
IDEHardDrive
PXEBoot
Disquete

Tipo:	BootDevice[]
Valores aceites:	Floppy, CD, IdeHardDrive, PxeBoot, Unknown
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

-CheckpointType

Especifica o tipo de ponto de verificação. Os valores aceitáveis para este parâmetro são:

Desabilitado
Produção
ProductionOnly
Padrão

Tipo:	CheckpointType
Valores aceites:	Disabled, Production, ProductionOnly, Standard
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ClearDRProtection

Indica que esse cmdlet redefine a opção de proteção de recuperação de dados.

Tipo:	SwitchParameter
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:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ClusterNonPossibleOwner

Especifica uma lista de nomes dos proprietários de nós de cluster não possíveis para uma máquina virtual especificada.

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

-ClusterPreferredOwner

Especifica uma lista de nomes dos proprietários de nós de cluster preferenciais para uma máquina virtual específica.

Tipo:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
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. Você pode coletar dados sobre a alocação de máquinas virtuais ou recursos alocados para máquinas virtuais para seu sistema de cobrança.

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

-CPUCount

Especifica o número de CPUs na máquina virtual. Os seguintes hosts suportam o seguinte número de processadores:

Hiper-V. Até quatro CPUs por máquina virtual, dependendo do sistema operacional convidado.
VMware ESX. Até quatro CPUs por máquina virtual para qualquer sistema operacional convidado suportado, exceto uma CPU em uma máquina virtual que executa o Windows NT 4.0.
Citrix XenServer. Até oito CPUs por máquina virtual, dependendo do sistema operacional convidado.

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

-CPUExpectedUtilizationPercent

Especifica a porcentagem de CPU no host que você espera que essa máquina virtual use. Esse valor é usado somente quando o VMM determina um host apropriado para a máquina virtual.

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

-CPULimitForMigration

Indica se os recursos do processador devem ser limitados para a máquina virtual especificada para habilitar a migração para um computador físico que tenha uma versão diferente do mesmo processador que o computador de origem. O VMM não oferece suporte à migração de máquinas virtuais entre computadores físicos com processadores de fabricantes diferentes.

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

-CPULimitFunctionality

Indica se a funcionalidade limitada da CPU deve ser fornecida para a máquina virtual. Especifique um valor de $True para oferecer suporte a um sistema operacional mais antigo, como o Windows NT 4.0, em uma máquina virtual implantada em um host Hyper-V ou em um host VMware ESX.

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

-CPUMaximumPercent

Especifica a maior porcentagem do total de recursos de uma única CPU no host que uma máquina virtual pode usar ao mesmo tempo.

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

-CPUPerVirtualNumaNodeMaximum

Especifica o número máximo de CPUs permitido para cada nó NUMA virtual.

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

-CPURelativeWeight

Especifica a quantidade de recursos da CPU em um host que essa máquina virtual pode usar em relação a outras máquinas virtuais no mesmo host. Uma máquina virtual com um valor de peso mais alto é alocada mais recursos de CPU do que uma máquina virtual com um valor de peso menor. O termo VMware para esses valores é ações. Os tipos de hosts suportam os seguintes valores relativos:

Hiper-V. 1 a 10000.
VMware ESX. Alta. 2000.
VMware ESX. Acima do normal. 1500.
VMware ESX. Normal (padrão). 1000.
VMware ESX. Abaixo do normal. 750.
VMware ESX. Baixa. 500.
VMware ESX. Personalizado de 1 a 1000000.
Citrix XenServer. 1 a 65536, típico é 256.

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

-CPUReserve

Especifica a porcentagem mínima dos recursos de uma única CPU no host a ser alocada para a máquina virtual. A porcentagem de capacidade da CPU disponível para a máquina virtual nunca é inferior a essa porcentagem.

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

-CPUType

Especifica o tipo de CPU para uma máquina virtual. Para obter todos os tipos de CPU disponíveis para uso em máquinas virtuais em um ambiente VMM, consulte o cmdlet Get-SCCPUType.

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