Set-SCVirtualMachine

Referência

Módulo:: VirtualMachineManager

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

As propriedades que pode alterar incluem o seguinte:

Associar uma máquina virtual a uma cloud.
Nome, proprietário e descrição de uma máquina virtual.
Ordem de arranque do BIOS, se a máquina virtual estiver implementada num anfitrião Hyper-V.
Quantidade de recursos no anfitrião utilizado por uma máquina virtual. Estes incluem o seguinte:
Quantidade máxima de recursos de CPU do anfitrião que uma máquina virtual pode utilizar.
Utilização esperada da CPU do anfitrião por uma máquina virtual.
Quantidade de recursos de CPU do anfitrião utilizados por uma máquina virtual relativamente a outras máquinas virtuais no mesmo anfitrião.
Quantidade de memória de anfitrião que uma máquina virtual pode utilizar.
Quantidade de largura de banda na rede do anfitrião que uma máquina virtual pode utilizar.
Definições de hardware para uma máquina virtual não relacionada com recursos de anfitrião. 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).
Limitação da funcionalidade da CPU para um sistema operativo mais antigo, como o Windows NT 4.0.
Centro de custos, etiquetas e definições personalizadas que são utilizadas para filtrar máquinas virtuais por critérios.
Definições que ativam várias capacidades opcionais, que incluem o seguinte:
Ativar ou desativar um objeto de biblioteca para o disponibilizar, ou temporariamente indisponível, aos utilizadores.
Ativar a cópia de segurança de uma máquina virtual num anfitrião Hyper-V com o serviço Cópia Sombra de Volumes.
Ativar um par chave/valor para troca de dados entre uma máquina virtual e o respetivo anfitrião Hyper-V.
Ativar o encerramento de uma máquina virtual a partir da consola do Hyper-V.
Ativar a sincronização de tempo entre uma máquina virtual e o respetivo anfitrião Hyper-V.
Ativar o valor bios para NumLock para uma máquina virtual num anfitrião Hyper-V.
Definição que identifica se uma máquina virtual é de elevada disponibilidade, ou seja, uma máquina virtual a ser implementada num nó de um cluster anfitrião Hyper-V ou num cluster anfitrião Citrix XenServer.
Definição que determina se os serviços de virtualização de convidados estão instalados numa máquina virtual implementada num anfitrião Hyper-V.
Número de segundos a atrasar antes de iniciar uma máquina virtual.
Definição que identifica o sistema operativo utilizado para uma máquina virtual.
Iniciar e parar ações de uma máquina virtual.
Definição que limita o número de máquinas virtuais que os utilizadores self-service podem criar.
Definição utilizada para mudar a função que um utilizador self-service que pertence a várias funções utiliza para gerir uma máquina virtual.
Definição que atribui uma máquina virtual num anfitrião ESX a um agrupamento de recursos VMware.

Se quiser alterar as propriedades de uma disquete virtual, unidade de DVD virtual, adaptador de rede virtual ou adaptador SCSI virtual associado a uma máquina virtual específica, utilize o cmdlet Set-SCVirtualFloppyDrive, Set-SCVirtualDVDDrive, Set-SCVirtualNetworkAdapter ou 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 da máquina virtual com o nome VM01 e, em seguida, armazena esse objeto na variável $VM.

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

O último comando altera a memória alocada à VM01 para 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 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 com o nome VM02 do VMMServer01 e, em seguida, armazena esse objeto na variável $VM.

O segundo comando obtém o objeto de função de utilizador com o nome ContosoSelfServiceUsers e, em seguida, armazena o objeto na variável $SSRole.

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

Nota: o VMM utiliza o parâmetro UserRole para definir as máquinas virtuais que são geridas pelos membros de uma função de utilizador self-service específica. Normalmente, não tem de 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 várias funções de utilizador self-service e lhes conceder permissão para gerir várias máquinas virtuais no mesmo anfitrião, poderá encontrar um caso em que pretende mudar a função de utilizador autorizada a gerir uma máquina virtual específica. Este exemplo ilustra esse cenário.

Exemplo 3: desativar a sincronização de 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 na variável $EAP. Esta variável é utilizada mais tarde para devolver a definição ao valor original.

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

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

O quarto comando desativa a definição de sincronização de hora. Normalmente, a desativação da sincronização de tempo é necessária para máquinas virtuais que atuam como controladores de domínio. O comando utiliza a instrução trap para capturar exceções de terminação. Se o comando Set-SCVirtualMachine falhar, a cadeia na instrução trap é apresentada. Continue é utilizado na instrução trap para continuar em execução em vez de sair. O cmdlet Out-Null redireciona o resultado para $Null em vez de enviá-lo para a consola do .

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

Exemplo 4: Definir 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 no $EAP. Esta variável é utilizada mais tarde para devolver a definição ao valor original.

O segundo comando define a preferência de ação de erro como Parar. Esta preferência de ação de erro altera um erro de um erro de não terminação para um erro de terminação. O objeto de erro é gerado como uma exceção em vez de ser escrito 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 no $VMs. A utilização do símbolo @ e dos parênteses garante 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 do BIOS para cada máquina virtual como PXEBoot,IDEHarddrive,CD, Floppy. O comando utiliza uma instrução trap para capturar exceções de terminação. Se o comando Set-SCVirtualMachine falhar, a cadeia na instrução trap é apresentada. Continue é utilizado na instrução trap para continuar em execução em vez de sair do ciclo ForEach . O cmdlet Out-Null redireciona o resultado para $Null em vez de enviá-lo para a consola do .

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 disquetes e, por conseguinte, ignoram a Disquete se estiverem listados na ordem de arranque.

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

Para obter mais informações sobre a instrução de ciclo standard Windows PowerShell ForEach, 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 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: 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 esse objeto na variável $VM. Para ativar a memória dinâmica numa máquina virtual, a máquina virtual tem de residir num anfitrião 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á num estado desligado. 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 ativa 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 anfitrião que é alocada à VM06 após o arranque. A memória máxima é a quantidade máxima de memória no anfitrião que é alocada à VM06.

Parâmetros

-AutomaticCriticalErrorAction

Especifica a ação a tomar quando a máquina virtual encontrar 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: 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, a 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 de conjuntos 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, dos dispositivos que uma máquina virtual num anfitrião Hyper-V utiliza para iniciar. Os valores válidos são:

CD
IDEHardDrive
PXEBoot
Disquesa

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çãoOnly
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 repõe 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 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 preferidos 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 custos de uma máquina virtual. Pode recolher dados sobre a alocação de máquinas virtuais ou recursos alocados 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 anfitriões seguintes suportam o seguinte número de processadores:

Hyper-V. Até quatro CPUs por máquina virtual, dependendo do sistema operativo convidado.
VMware ESX. Até quatro CPUs por máquina virtual para qualquer sistema operativo convidado suportado, exceto uma 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 convidado.

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 anfitrião que espera que esta máquina virtual utilize. Este valor só é utilizado quando o VMM determina um anfitrião 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 pretende limitar as funcionalidades do processador da máquina virtual especificada para permitir 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 suporta a migração de máquinas virtuais entre computadores físicos que tenham 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 funcionalidades de CPU limitadas 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 implementada 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 percentagem mais elevada do total de recursos de uma única CPU no anfitrião que uma máquina virtual pode utilizar 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ó virtual de NUMA.

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

-CPURelativeWeight

Especifica a quantidade de recursos da CPU num anfitrião que esta máquina virtual pode utilizar em relação a outras máquinas virtuais no mesmo anfitrião. Uma máquina virtual com um valor de peso mais elevado é alocado mais recursos de CPU do que uma máquina virtual com um valor de peso mais baixo. O termo VMware para estes valores são partilhas. Os tipos de anfitriões suportam os seguintes valores relativos:

Hyper-V. De 1 a 10 000.
VMware ESX. Elevada. 2000.
VMware ESX. Acima do Normal. 1500.
VMware ESX. Normal (predefinição). 1000.
VMware ESX. Abaixo de Normal. 750.
VMware ESX. Baixo. 500.
VMware ESX. Personalizado de 1 a 100 00000.
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 uma única CPU no anfitrião a alocar à máquina virtual. A percentagem de capacidade da CPU que está 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 disponíveis para utilização em máquinas virtuais num ambiente VMM, veja o cmdlet Get-SCCPUType .

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