Set-SCVirtualMachine

Referência

Módulo:: VirtualMachineManager

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

Syntax

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. Entre elas estão as seguintes:
Quantidade máxima de recursos de CPU de host que uma máquina virtual pode usar.
Uso esperado da CPU do host por uma máquina virtual.
Quantidade de recursos de CPU de 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 a recursos de host. Entre elas estão as seguintes:
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 Windows NT 4.0.
Central de custos, marcação 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.
Habilitando o backup de uma máquina virtual em um host Hyper-V com o serviço 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 do 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-SCVirtualNetworkAdapter ou 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 a eles permissão para gerenciar várias máquinas virtuais no mesmo host, você 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: 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 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 término. 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 trap será exibida. Continue é usado na instrução trap 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 terminação para um erro de término. 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 que 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 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 no EAP.

Para obter mais informações sobre a instrução de loop standard Windows PowerShell ForEach, digiteGet-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"

Esse 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 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 alocado à VM06 após a inicialização. A memória máxima é a quantidade máxima de memória no host alocado à 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 este parâmetro são: Pausar e Nenhum.

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

-AutomaticCriticalErrorActionTimeout

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

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

-AvailabilitySetNames

Especifica uma lista de nomes do 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

-BlockDynamicOptimization

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

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

Type:	BootDevice[]
Accepted values:	Floppy, CD, IdeHardDrive, PxeBoot, Unknown
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

-CheckpointType

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

Desabilitado
Produção
ProductionOnly
Standard

Type:	CheckpointType
Accepted values:	Disabled, Production, ProductionOnly, Standard
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearDRProtection

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

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

-Cloud

Especifica um objeto de nuvem privado.

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

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

-ClusterPreferredOwner

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

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
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. 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.

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

-CPUCount

Especifica o número de CPUs na máquina virtual. Os seguintes hosts 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 é executada Windows NT 4.0.
Citrix XenServer. Até oito CPUs por máquina virtual, dependendo do sistema operacional convidado.

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

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

Type:	Boolean
Aliases:	LimitCPUForMigration
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 Windows NT 4.0, em uma máquina virtual implantada em um host Hyper-V ou em um host ESX VMware.

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

Type:	Int32
Aliases:	CPUMax
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUPerVirtualNumaNodeMaximum

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

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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. Alta: 2000.
VMware ESX. Acima do Normal. 1500.
VMware ESX. Normal (padrão). 1.000.
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.

Type:	Int32
Aliases:	RelativeWeight
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUReserve

Especifica a porcentagem mínima dos recursos de uma única CPU no host a ser alocada à máquina virtual. O percentual de capacidade da CPU disponível para a máquina virtual nunca é menor que esse percentual.

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

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