Set-SCVirtualMachine

Referência

Módulo:: VirtualMachineManager

Altera as propriedades de uma máquina virtual gerida por 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 gerida pelo Virtual Machine Manager (VMM).

As propriedades que pode alterar incluem o seguinte:

Associe uma máquina virtual a uma nuvem.
Nome, proprietário e descrição de uma máquina virtual.
Pedido de arranque BIOS, se a máquina virtual for implantada num hospedeiro Hiper-V.
Quantidade de recursos no hospedeiro usado por uma máquina virtual. Estes incluem o seguinte:
Quantidade máxima de recursos cpu hospedeiros que uma máquina virtual pode usar.
Utilização esperada do CPU hospedeiro por uma máquina virtual.
Quantidade de recursos cpu hospedeiros utilizados por uma máquina virtual relativamente a outras máquinas virtuais no mesmo hospedeiro.
Quantidade de memória hospedeira que uma máquina virtual pode usar.
Quantidade de largura de banda na rede do anfitrião que uma máquina virtual pode usar.
Definições de hardware para uma máquina virtual não relacionada com os recursos de hospedar. 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 CPU, para um sistema operativo mais antigo, como o Windows NT 4.0.
Centro de custos, etiquetas e configurações personalizadas que são usadas para filtrar máquinas virtuais por critérios.
Configurações que permitem várias capacidades opcionais, que incluem as seguintes:
Habilitando ou desativando um objeto de biblioteca para torná-lo disponível, ou temporariamente indisponível, para os utilizadores.
Ativando o backup de uma máquina virtual num anfitrião Hyper-V com o serviço Volume Shadow Copy.
Ativando um par de chaves/valor para troca de dados entre uma máquina virtual e o seu anfitrião Hyper-V.
Ativando o encerramento de uma máquina virtual a partir da consola Hyper-V.
Ativando a sincronização do tempo entre uma máquina virtual e o seu anfitrião Hyper-V.
Ativar o valor BIOS para NumLock para uma máquina virtual num hospedeiro Hiper-V.
Definição que identifica se uma máquina virtual está altamente disponível, ou seja, uma máquina virtual a ser implantada num nó de um cluster de hospedeiro Hiper-V ou um cluster de hospedeiro Citrix XenServer.
Definição que determina se os serviços de virtualização de hóspedes são instalados numa máquina virtual implantada num anfitrião Hiper-V.
Número de segundos para atrasar antes de iniciar uma máquina virtual.
Definição que identifica o sistema operativo que é utilizado para uma máquina virtual.
Inicie e pare as ações para uma máquina virtual.
Definição que limita o número de máquinas virtuais que os utilizadores de self-service podem criar.
A definição usada para mudar o papel que um utilizador de self-service que pertence a várias funções usa para gerir uma máquina virtual.
Definição que atribui uma máquina virtual num anfitrião ESX a um conjunto de recursos VMware.

Se pretender alterar as propriedades de uma unidade virtual floppy, unidade de DVD virtual, adaptador de rede virtual ou adaptador SCSI virtual associado a uma máquina virtual específica, utilize o Set-SCVirtualFloppyDrive, Set-SCVirtualDVDDrive, Set-SCVirtualNetworkAdapter ou Set-SCVirtualSiAdapter 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 recebe o objeto da máquina virtual chamado VM01, e depois armazena esse objeto na variável $VM.

O segundo determina se a máquina virtual armazenada em $VM está num estado de desligação. Se a máquina virtual não estiver num estado de desligamento, o comando utiliza o comando Stop-SCVirtualMachine para desligar a máquina virtual. Para obter mais informações sobre a alimentação de uma máquina virtual, escreva Get-Help Stop-SCVirtualMachine.

O último comando altera a memória atribuída a VM01 a 1024 MB.

Exemplo 2: Alterar a função de utilizador utilizada para gerir uma máquina virtual para um utilizador que pertence a várias funções de utilizador de self-service

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 da função do utilizador chamado ContosoSelfServiceUsers e, em seguida, armazena o objeto na variável $SSRole.

O último comando especifica que os membros da função de utilizador de self-service chamado SSUserRole3 têm agora a permissão para gerir a máquina virtual chamada VM02.

Nota: O VMM utiliza o parâmetro UserRole para definir quais as máquinas virtuais geridas pelos membros de uma função específica de utilizador de autosserviço. Normalmente, não é necessário utilizar o cmdlet Set-SCVirtualMachine com o parâmetro UserRole para configurar esta definição. No entanto, se um ou mais utilizadores forem membros de múltiplas funções de utilizador de autosserviço e lhes conceder permissão para gerir várias máquinas virtuais no mesmo anfitrião, poderá encontrar um caso em que pretenda mudar a função de utilizador autorizada a gerir uma determinada máquina virtual. Este exemplo ilustra este cenário.

Exemplo 3: Desativar a sincronização do tempo numa máquina virtual utilizada 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 definição atual para $ErrorActionPreference em $EAP variáveis. Esta variável é usada mais tarde para devolver a definição ao seu valor original.

O segundo comando define a preferência de ação para STOP. Esta preferência de ação de erro altera um erro de um erro não terminante para um erro de terminação. O objeto de erro é levantado como uma exceção em vez de ser escrito no tubo de saída, e o comando não continua a funcionar.

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

O quarto comando desativa a definição de sincronização de tempo. Normalmente, a sincronização do tempo é necessária para máquinas virtuais que atuam como controladores de domínio. O comando usa a declaração de armadilha para apanhar exceções de fim. Se o comando Set-SCVirtualMachine falhar, é apresentada a corda na declaração da armadilha . Continue a ser utilizado na declaração da armadilha para continuar a correr em vez de sair. O Out-Null cmdlet redireciona a saída para $Null em vez de enviá-la para a consola.

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

Exemplo 4: Desemordene a ordem de início do dispositivo para todas as máquinas virtuais que suportam esta funcionalidade

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 definição atual para $ErrorActionPreference em $EAP. Esta variável é usada mais tarde para devolver a definição ao seu valor original.

O segundo comando define a preferência de ação por erro para parar. Esta preferência de ação de erro altera um erro de um erro não terminante para um erro de terminação. O objeto de erro é levantado como uma exceção em vez de ser escrito no tubo de saída, e o comando não continua a funcionar.

O terceiro comando obtém cada objeto de máquina virtual armazena os objetos em $VMs. A utilização do símbolo @ e dos parênteses assegura-se de que o comando armazena os resultados numa matriz caso o comando devolva um único objeto ou um valor nulo.

O quarto comando define a ordem de arranque BIOS para cada máquina virtual para PXEBoot,IDEHarddrive,CD,Floppy. O comando usa uma declaração de armadilha para apanhar exceções de fim. Se o comando Set-SCVirtualMachine falhar, é apresentada a corda na declaração da armadilha. Continue a ser utilizado na declaração de armadilha para continuar a correr em vez de sair do circuito ForEach . O cmdlet Out-Null redireciona a saída para $Null em vez de enviá-la para a consola.

Nota: O parâmetro BootOrder é utilizado apenas para máquinas virtuais em anfitriões Hyper-V e Citrix XenServer. Não é utilizado para máquinas virtuais em anfitriões VMware ESX. Os anfitriões XenServer não suportam discos floppy, e, portanto, ignora floppy se listado na ordem de arranque.

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

Para obter mais informações sobre a declaração padrão Windows PowerShell ForEach loop, escreva 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 virtuais no VMMServer01, seleciona apenas os objetos de máquina virtuais onde nenhum proprietário está listado, e especifica um proprietário para cada máquina virtual.

Exemplo 6: Ativar a 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 o objeto na variável $VM. Para permitir a memória dinâmica numa máquina virtual, a máquina virtual deve residir num anfitrião que executa o Windows Server 2008 R2 SP1 ou uma versão posterior.

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

O último comando permite a Memória Dinâmica, define a memória de arranque para 1024 MB e define a memória máxima para 2048 MB. A memória de arranque é a quantidade de memória no hospedeiro que é atribuída ao VM06 no arranque. A memória máxima é a quantidade máxima de memória no hospedeiro que é atribuída a VM06.

Parâmetros

-AutomaticCriticalErrorAction

Especifica a ação a tomar quando a máquina virtual encontra um erro crítico e excede a duração do tempo limite especificada pelo parâmetro AutomáticaCriticalErrorActionTimeout . Os valores aceitáveis para este parâmetro são: Pausa 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 esperar 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 definidos 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 num hospedeiro Hiper-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 capacidade.

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 este parâmetro são:

Desativado
Produção
ProduçãoOnamente
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 este cmdlet reinicia 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 privada.

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

-ClusterNonPossibleOwner

Especifica uma lista de nomes dos não possíveis proprietários de nós de agrupamento 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óis de cluster preferidos para uma determinada máquina virtual.

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 custos para uma máquina virtual. Pode recolher dados sobre a atribuição de máquinas virtuais ou recursos atribuídos a máquinas virtuais para o seu sistema de faturação.

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 anfitriões suportam o seguinte número de processadores:

Hiper-V. Até quatro CPUs por máquina virtual, dependendo do sistema operativo do hóspede.
VMware ESX. Até quatro CPUs por máquina virtual para qualquer sistema operativo de hóspedes suportado, exceto um CPU numa máquina virtual que execute o Windows NT 4.0.
Citrix XenServer. Até oito CPUs por máquina virtual, dependendo do sistema operativo do hóspede.

Type:	Byte
Aliases:	ProcessorCount
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUExpectedUtilizationPercent

Especifica a percentagem de CPU no hospedeiro que espera que esta máquina virtual utilize. Este valor só é utilizado quando o VMM determina um hospedeiro adequado 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 deve limitar as funcionalidades do processador para a máquina virtual especificada de modo a permitir a migração para um computador físico que tenha uma versão diferente do mesmo processador que o computador de origem. A VMM não suporta máquinas virtuais migratórias 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 deve fornecer uma funcionalidade limitada de CPU para a máquina virtual. Especifique um valor de $True para suportar um sistema operativo mais antigo, como o Windows NT 4.0, numa máquina virtual implantada num anfitrião Hyper-V ou num anfitrião VMware ESX.

Type:	Boolean
Aliases:	LimitCPUFunctionality
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CPUMaximumPercent

Especifica a maior percentagem dos recursos totais de um único CPU no hospedeiro 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 permitido 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 cpu num hospedeiro que esta máquina virtual pode usar em relação a outras máquinas virtuais no mesmo hospedeiro. Uma máquina virtual com um valor de peso mais elevado é atribuída mais recursos CPU do que uma máquina virtual com um valor de peso mais baixo. O termo VMware para estes valores é partilha. Os tipos de anfitriões suportam os seguintes valores relativos:

Hiper-V. 1 a 10000.
VMware ESX. Elevada. 2000.
VMware ESX. Acima do normal. 1500.
VMware ESX. Normal (predefiniçã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.

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

-CPUReserve

Especifica a percentagem mínima dos recursos de um único CPU no hospedeiro para alocar à máquina virtual. A percentagem de capacidade de CPU disponível para a máquina virtual nunca é inferior a esta percentagem.

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 que estão disponíveis para utilização em máquinas virtuais em ambiente VMM, consulte o cmdlet Get-SCCPUType .

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