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 VMM (Virtual Machine Manager).

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 de 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 relacionada aos recursos de 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 custos, marca 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 disponibilizá-lo ou temporariamente indisponível aos usuários.
Habilitar o backup de uma máquina virtual em um host Hyper-V com o serviço de Cópia 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.
Habilitando 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 um cluster de host Citrix XenServer.
Configuração que determina se os serviços convidados de virtualização estão instalados em uma máquina virtual implantada em um host Hyper-V.
Número de segundos para atrasar antes de iniciar uma máquina virtual.
Configuração que identifica o sistema operacional usado para uma máquina virtual.
Inicie e interrompa as ações de 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 do VMware.

Se você quiser 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 Set-SCVirtualScsiAdapter cmdlet.

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 armazena esse objeto na variável $VM.

O segundo determina se a máquina virtual armazenada em $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 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, você não precisa 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 para gerenciar várias máquinas virtuais no mesmo host, poderá encontrar um caso em que você 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: Desabilitar 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 em $EAP variáveis. 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 encerramento 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 desabilita a configuração de sincronização de tempo. Normalmente, a desabilitaçã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 de interceptação será exibida. Continue é usado na instrução de interceptação para continuar em 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 dão suporte a esse 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 em $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 encerramento 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 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, Disquete. 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 em execução em vez de sair do loop forEach . O cmdlet Out-Null redireciona a saída para $Null em vez de enviá-la para o console.

Observação: 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 dão suporte a 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 em EAP.

Para obter mais informações sobre a instrução de loop deForEach do Windows PowerShell padrão, digite .

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"

Esse comando obtém todos os objetos de máquina virtual no VMMServer01, seleciona apenas os objetos da 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 em $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 que é alocada para VM06 na inicialização. A memória máxima é a quantidade máxima de memória no host alocado para VM06.

Parâmetros

-AutomaticCriticalErrorAction

Especifica a ação a ser executada 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 esse parâmetro são: Pause e None.

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

-AutomaticCriticalErrorActionTimeout

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

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

-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

-BlockDynamicOptimization

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

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

CD
IDEHardDrive
PXEBoot
Disquete

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

-CheckpointType

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

Desactivado
Produção
ProductionOnly
Padrão

Tipo:	CheckpointType
Valores aceitos:	Disabled, Production, ProductionOnly, Standard
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ClearDRProtection

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

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

-CPUCount

Especifica o número de CPUs na máquina virtual. Os hosts a seguir dão suporte ao seguinte número de processadores:

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

-CPUExpectedUtilizationPercent

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

-CPULimitForMigration

Indica se os recursos de 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 dá suporte à migração de máquinas virtuais entre computadores físicos que têm processadores de diferentes fabricantes.

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

-CPULimitFunctionality

Indica se a funcionalidade de CPU limitada deve ser fornecida para a máquina virtual. Especifique um valor de $True para dar 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
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CPUPerVirtualNumaNodeMaximum

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

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

-CPURelativeWeight

Especifica a quantidade de recursos de 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 é compartilhamentos. Os tipos de hosts dão suporte aos seguintes valores relativos:

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

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

-CPUReserve

Especifica o percentual mínimo dos recursos de uma única CPU no host para alocar à máquina virtual. O percentual de capacidade de CPU disponível para a máquina virtual nunca é menor que esse percentual.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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 do VMM, consulte o cmdlet Get-SCCPUType .

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