Set-SCVMTemplate

Altera as propriedades de um modelo de máquina virtual usado no VMM.

Syntax

Set-SCVMTemplate
   [-VMTemplate] <Template>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-ApplicationProfile <ApplicationProfile>]
   [-SQLProfile <SQLProfile>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-LinuxDomainName <String>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled <Boolean>]
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-UpdateManagementProfile <AzureProfile>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-Domain <String>]
   [-DeploymentTypeNano <Boolean>]
   [-Workgroup <String>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-UserRole <UserRole>]
   [-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>]
   [<CommonParameters>]
Set-SCVMTemplate
   [-VMTemplate] <Template>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-ApplicationProfile <ApplicationProfile>]
   [-SQLProfile <SQLProfile>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-LinuxDomainName <String>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled <Boolean>]
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-UpdateManagementProfile <AzureProfile>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-Domain <String>]
   [-DeploymentTypeNano <Boolean>]
   [-Workgroup <String>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-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>]
   [<CommonParameters>]

Description

Observação

Um novo parâmetro [-EnableNestedVirtualization] está incluído no VMM 2019 UR1. Para obter mais informações, confira Parâmetros.

O cmdlet Set-SCVMTemplate altera uma ou mais propriedades de um modelo de máquina virtual usado em um ambiente do VMM (Virtual Machine Manager).

As propriedades que você pode alterar incluem configurações para o nome do modelo, sua descrição, proprietário, nome da organização, fuso horário, sistema operacional e chave do produto; Ordem de inicialização do BIOS; Número e características da CPU; a quantidade de memória no host atribuída a uma máquina virtual; a quantidade de largura de banda na rede do host disponível para uma máquina virtual; se uma máquina virtual criada com este modelo estará altamente disponível (ou seja, implantada em um host que faz parte de um cluster de host); valores para domínio ou grupo de trabalho, bem como credenciais de domínio; uma cota de ponto que especifica quantas novas máquinas virtuais os usuários de autoatendimento podem criar; campos personalizados; e outras opções.

As alterações feitas em um modelo afetam apenas o modelo. As alterações não afetam as máquinas virtuais existentes que foram criadas anteriormente usando esse modelo.

Se você quiser alterar as propriedades de uma unidade de disco virtual, unidade de disquete virtual, unidade de DVD virtual, adaptador de rede virtual, adaptador SCSI virtual ou porta COM virtual associada a um modelo específico, você pode usar Set-SCVirtualDiskDrive, Set-SCVirtualFloppyDrive, Set-SCVirtualDVDDrive, Set-SCVirtualNetworkAdapter, Set-SCVirtualScsiAdapter ou Set-SCVirtualCOMPort cmdlets, respectivamente.

Exemplos

Exemplo 1: especificar uma quantidade de memória para um modelo de máquina virtual existente

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Set-SCVMTemplate -Template $Template -MemoryMB 1024

O primeiro comando obtém o objeto de modelo de máquina virtual chamado VMTemplate01 da biblioteca do VMM e armazena o objeto na variável $Template.

O segundo comando altera o valor de memória para VMTemplate01 para 1024 MB. Essa é a quantidade de memória no host que uma máquina virtual criada usando este modelo usará.

Exemplo 2: especificar um novo proprietário para vários modelos de máquina virtual altamente disponíveis

PS C:\> $VMTemplates = Get-SCVMTemplate | where {$_.IsHighlyAvailable}
PS C:\> ForEach ($VMTemplate in $VMTemplates) {Set-SCVMTemplate $VMTemplate -Owner "Contoso\NevenSokec"}

O primeiro comando obtém todos os objetos de modelo de máquina virtual altamente disponíveis e armazena os objetos na matriz de objetos $VMTemplates.

O segundo comando usa um loop ForEach para especificar um novo proprietário para cada um dos modelos na matriz $VMTemplates.

Para obter informações sobre a instrução de loop padrão do PowerShell ForEach, digiteGet-Help about_ForEach.

Exemplo 3: especificar um novo proprietário para todos os modelos de máquina virtual que têm o mesmo proprietário

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

Esse comando obtém todos os objetos de modelo de máquina virtual da biblioteca do VMM, seleciona apenas os objetos cujo proprietário é "Contoso\PattiFuller" e, em seguida, passa cada objeto para o cmdlet Set-SCVMTemplate , que altera o proprietário para Contoso| AllieSloan.

Exemplo 4: Habilitar Memória Dinâmica para um modelo de máquina virtual existente

PS C:\> $VMTemplate = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate04"}
PS C:\> Set-SCVMTemplate -VMTemplate $VMTemplate -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

O primeiro comando obtém o objeto de modelo de máquina virtual chamado VMTemplate04 da biblioteca do VMM e armazena o objeto na variável $VMTemplate.

O segundo comando permite memória dinâmica, altera o valor de memória de inicialização para VMTemplate04 para 1024 MB (essa é a quantidade de memória no host que uma máquina virtual criada usando esse modelo é alocada na inicialização) e define o valor máximo de memória como 2048 MB (essa é a quantidade máxima de memória que pode ser alocada a uma máquina virtual criada usando esse modelo). Uma máquina virtual que usa memória dinâmica só pode ser implantada em um host que esteja executando o Windows Server 2008 R2 SP1 ou posterior.

Exemplo 5: especificar a senha raiz para um modelo de máquina virtual linux personalizável existente

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "LinuxVMTemplate01"}
PS C:\> $Creds = Get-Credential
PS C:\> Set-SCVMTemplate -Template $Template -LocalAdministratorCredential $Creds

O primeiro comando obtém o objeto de modelo de máquina virtual chamado LinuxVMTemplate01 da biblioteca do VMM e armazena o objeto na variável $Template.

O segundo comando obtém um nome de usuário (raiz) e uma senha por meio do comando Get-Credential e armazena o resultado na variável $Creds.

O último comando define a senha da conta raiz como a senha armazenada na variável $Creds.

Exemplo 6: habilitar os recursos de gerenciamento de atualizações do Azure em um modelo de VM existente.

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> $azureProfile = Get-SCAzureProfile | where { $_.Name -eq "AzUpdateMgmtProfile"}
PS C:\> Set-SCVMTemplate -Template $Template -UpdateManagementProfile $azureProfile

O primeiro comando obtém o objeto de modelo de máquina virtual chamado VMTemplate01 da biblioteca do VMM e armazena o objeto na variável $Template.

O segundo comando obtém um perfil de gerenciamento de atualizações do azure da biblioteca do VMM e armazena o objeto na variável $azureProfile.

O terceiro comando habilita o modelo com recursos de gerenciamento de atualizações do azure vinculando um perfil do azure.

Exemplo 7: desabilitar os recursos de gerenciamento de atualizações do Azure em um modelo de VM.

PS C:\> $Template = Get-SCVMTemplate | where {$_.Name -eq "VMTemplate01"}
PS C:\> Set-SCVMTemplate -Template $Template -UpdateManagementProfile $null

O primeiro comando obtém o objeto de modelo de máquina virtual chamado VMTemplate01 da biblioteca do VMM e armazena o objeto na variável $Template.

O segundo comando desabilita o modelo com recursos de gerenciamento de atualizações do Azure.

Parâmetros

-AnswerFile

Especifica um objeto de script armazenado na biblioteca do VMM (Virtual Machine Manager) a ser usado como um arquivo de resposta. O nome do script de arquivo de resposta depende do sistema operacional que você deseja instalar em uma máquina virtual:

  • Sysprep.inf. Windows XP, Windows Server 2000 ou Windows Server 2003
  • Unattend.xml. Windows Vista, Windows 7 ou Windows Server 2008
Type:Script
Aliases:SysPrepFile
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationProfile

Especifica um objeto de perfil de aplicativo.

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

-AutoLogonCount

Especifica o número de vezes que o Windows deve registrar automaticamente o administrador indicado no Arquivo de Resposta na sessão do console.

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

-AutoLogonCredential

Especifica a conta Executar como contida no arquivo de resposta que o Windows usa para fazer logon na sessão do console quando o logon automático do administrador está habilitado.

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

-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

-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 checkpoint. 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 desastre.

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

-ComputerName

Especifica o nome de um computador que o VMM pode identificar exclusivamente em sua rede. Os valores aceitáveis para esse parâmetro são:

  • FQDN
  • Endereço IPv4 ou IPv6
  • Nome NetBIOS
Type:String
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 para que você possa coletar dados sobre a alocação de máquinas virtuais (ou recursos alocados para máquinas virtuais) para fazer uso em 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 em uma máquina virtual, em um perfil de hardware ou em um modelo.

Os tipos de hosts dão suporte ao seguinte número de CPUs:

  • Hyper-V. Até quatro CPUs por máquina virtual, dependendo do sistema operacional convidado.
  • VMware ESX. Até quatro CPUs por máquina virtual, mas apenas uma CPU em uma máquina virtual que executa 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 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 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 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 é necessário habilitar a execução de 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 VMware ESX, fornecendo funcionalidade limitada de CPU para a máquina virtual.

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 pode ser usada por uma máquina virtual específica a qualquer momento.

Exemplo: -CPUMaximumPercent 80 (para especificar 80 por cento)

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, normal é 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 a uma 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 recuperar uma lista de todos os tipos de CPU disponíveis para uso em máquinas virtuais em um ambiente do VMM, digite Get-SCCPUType.

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

-Custom1

Especifica uma propriedade personalizada em um modelo de máquina virtual.

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

-Custom10

Especifica uma propriedade personalizada em um modelo de máquina virtual.

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

-Custom2

Especifica uma propriedade personalizada em um modelo de máquina virtual.

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

-Custom3

Especifica uma propriedade personalizada em um modelo de máquina virtual.

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

-Custom4

Especifica uma propriedade personalizada em um modelo de máquina virtual.

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

-Custom5

Especifica uma propriedade personalizada em um modelo de máquina virtual.

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

-Custom6

Especifica uma propriedade personalizada em um modelo de máquina virtual.

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

-Custom7

Especifica uma propriedade personalizada em um modelo de máquina virtual.

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

-Custom8

Especifica uma propriedade personalizada em um modelo de máquina virtual.

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

-Custom9

Especifica uma propriedade personalizada em um modelo de máquina virtual.

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

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

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

-Description

Especifica uma descrição para o modelo de máquina virtual.

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

-DisableAutoLogon

Desabilita o logon de administrador automático.

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

-DiskIops

Especifica o número de operações de entrada/saída de disco por segundo (IOPS) no host que pode ser usado por uma máquina virtual específica.

Exemplo: -DiskIO 1500 (para especificar 1500 IOPS)

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

-Domain

Especifica um FQDN (nome de domínio totalmente qualificado) para um domínio do Active Directory.

Formato de exemplo: -Domain "Domain01.Corp.Contoso.com"

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

-DomainJoinCredential

Especifica o nome de usuário e a senha de uma conta que tem permissão para ingressar um computador no domínio. Recomendamos que você use uma conta de direitos limitada que une computadores ao domínio. Isso inclui computadores virtuais e físicos.

Você pode usar o parâmetro atual para especificar credenciais em um VMHostProfile para ingressar um computador host físico no domínio ou especificar credenciais, em um modelo novo ou existente, em um perfil de sistema operacional convidado novo ou existente, ou em uma nova máquina virtual, para ingressar uma máquina virtual no domínio.

Type:VMMCredential
Aliases:JoinDomainCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DomainJoinOrganizationalUnit

Especifica a unidade organizacional à qual o computador é ingressado durante uma mini-instalação autônoma.

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

-DRProtectionRequired

Esse parâmetro é reservado para uso futuro.

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

-DynamicMemoryBufferPercentage

Especifica a porcentagem de memória acima da alocação de memória atual de uma máquina virtual que o host deve tentar reservar como um buffer. O valor padrão é 20.

Formato de exemplo: -DynamicMemoryTargetBufferPercentage 20

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

-DynamicMemoryEnabled

Indica se a memória dinâmica deve ser habilitada para máquinas virtuais. Você pode habilitar a memória dinâmica diretamente em uma máquina virtual ou em um modelo ou perfil de hardware usado para criar máquinas virtuais. O valor padrão é False.

Obrigatório: você pode habilitar a memória dinâmica para uma máquina virtual somente se essa máquina virtual for implantada em um host executando o Windows Server 2008 SP1 ou posterior ou se a máquina virtual estiver armazenada em uma biblioteca em um estado parado (alterações de hardware em uma máquina virtual armazenada só poderão ser feitas se a máquina virtual não tiver instantâneos). Habilitar a memória dinâmica em uma máquina virtual armazenada em uma biblioteca limita o posicionamento desse computador para hosts que executam o Windows Server 2008 SP1 ou posterior.

Formato de exemplo: -DynamicMemoryEnabled $True

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

-DynamicMemoryMaximumMB

Especifica a quantidade máxima de memória que pode ser alocada a uma máquina virtual se a memória dinâmica estiver habilitada. O valor padrão é 65536.

Obrigatório: você só poderá habilitar a memória dinâmica para uma máquina virtual se essa máquina virtual for implantada em um host executando o Windows Server 2008 R2 SP1 ou posterior ou se a máquina virtual estiver armazenada em uma biblioteca em um estado parado (as alterações de hardware em uma máquina virtual armazenada só poderão ser feitas se a máquina virtual não tiver instantâneos). Habilitar a memória dinâmica em uma máquina virtual armazenada em uma biblioteca limitará o posicionamento desse computador para hosts que executam o Windows Server 2008 R2 SP1 ou posterior.

Formato de exemplo: -DynamicMemoryMaximumMB 1024

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

-DynamicMemoryMinimumMB

Especifica a quantidade mínima de memória que pode ser alocada a uma máquina virtual se a memória dinâmica estiver habilitada. O valor padrão é 65536.

Obrigatório: você só poderá habilitar a memória dinâmica para uma máquina virtual se essa máquina virtual for implantada em um host executando o Windows Server 2008 R2 SP1 ou posterior ou se a máquina virtual estiver armazenada em uma biblioteca em um estado parado (as alterações de hardware em uma máquina virtual armazenada só poderão ser feitas se a máquina virtual não tiver instantâneos). Habilitar a memória dinâmica em uma máquina virtual armazenada em uma biblioteca limitará o posicionamento desse computador para hosts que executam o Windows Server 2008 R2 SP1 ou posterior.

Formato de exemplo: -DynamicMemoryMinimumMB 1024

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

-Enabled

Habilita um objeto quando definido como $True ou desabilita um objeto quando definido como $False. Por exemplo, se você quiser atualizar o software em um modelo de máquina virtual, poderá desabilitar o objeto de modelo na biblioteca do VMM para impedir temporariamente que os usuários usem esse objeto.

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

-EnableNestedVirtualization

Habilita a virtualização aninhada.

Observação

Esse parâmetro é aplicável ao VMM 2019 UR1.

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

-FirstBootDevice

Especifica o dispositivo no qual uma inicialização é tentada pela primeira vez.

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

-FullName

Especifica o nome da pessoa em cujo nome uma máquina virtual está registrada.

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

-GuiRunOnceCommands

Especifica uma matriz de comandos a serem adicionados à seção [GuiRunOnce] de um arquivo de resposta autônomo. Use aspas simples em torno de cada cadeia de caracteres entre aspas duplas.

Formato de exemplo: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Para obter informações sobre como Windows PowerShell usa aspas, digite Get-Help about_Quoting_Rules.

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

-HAVMPriority

Especifica a prioridade da máquina virtual. As máquinas virtuais começam na ordem de prioridade até os limites de um nó de cluster de host. A entrada válida para esse parâmetro é uma representação numérica da prioridade:

  • Alta: 3000
  • Média: 2000
  • Baixa: 1000

Se você especificar um valor zero (0), a máquina virtual não será reiniciada automaticamente.

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

-HighlyAvailable

Indica se uma máquina virtual deve ser colocada em um host Hyper-V que faz parte de um cluster de host. Defina essa configuração em uma máquina virtual ou em um modelo ou perfil de hardware que será usado para criar máquinas virtuais.

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

-JobGroup

Especifica um identificador para uma série de comandos que são executados como um conjunto antes do comando final que inclui o mesmo identificador de grupo de trabalho executado.

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

-JobVariable

Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

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

-LinuxAdministratorSSHKey

Especifica o arquivo de chave pública para uma chave SSH do Linux.

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

-LinuxAdministratorSSHKeyString

Especifica uma chave SSH do administrador do Linux como uma cadeia de caracteres.

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

-LinuxDomainName

Especifica um FQDN (nome de domínio totalmente qualificado) a ser usado em conjunto com a especialização do sistema operacional Linux.

Formato de exemplo: -LinuxDomainName "Domain01.Corp.Contoso.com"

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

-LocalAdministratorCredential

Especifica o nome de usuário e a senha para a conta administrador local (ou conta raiz do Linux no caso de um perfil do Sistema Operacional Convidado compatível com Linux).

Especificar credenciais em um modelo novo ou existente, em um perfil de sistema operacional convidado novo ou existente ou em uma nova máquina virtual substitui qualquer senha de Administrador existente.

Type:VMMCredential
Aliases:AdminPasswordCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MemoryMB

Especifica a quantidade de memória de acesso aleatório (RAM), em megabytes (MB), no host que esse cmdlet aloca para a máquina virtual convertida. O valor padrão é de 512 MB. Para uma máquina virtual na qual a memória dinâmica está habilitada em um host que executa o Windows Server 2008 R2 SP1 ou versões posteriores, especifique o valor da memória de inicialização.

Os tipos de hosts têm o seguinte máximo de memória atribuível a máquinas virtuais:

  • Hyper-V. Até 65536 MB de RAM por máquina virtual.
  • VMware ESX Server 3.0.x. Até 16384 MB de RAM por máquina virtual.
  • VMware ESX Server 3.5.x. Até 65532 MB de RAM por máquina virtual.
  • Citrix XenServer. Até 32265 MB de RAM por máquina virtual.
Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MemoryPerVirtualNumaNodeMaximumMB

Especifica a quantidade máxima de memória, em MB, que cada nó NUMA virtual é permitido.

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

-MemoryWeight

Indica a prioridade na alocação de memória para uma máquina virtual, em relação a outras máquinas virtuais no mesmo host. Uma máquina virtual com uma configuração mais alta é alocada mais recursos de memória do que uma máquina virtual com uma configuração mais baixa.

Para um host que executa o Windows Server 2008 R2 SP1 ou posterior, 5000 = Normal, 10000 = Alto, 0 = Baixo, 1 a 10000 = Personalizado.

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

-MergeAnswerFile

Indica se esse cmdlet mescla o arquivo de resposta com as configurações do sistema operacional convidado. O valor padrão é $True. O console do VMM usa esse parâmetro. Não especifique esse parâmetro.

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

-MonitorMaximumCount

Especifica o número máximo de monitores compatíveis com um adaptador de vídeo virtual.

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

-MonitorMaximumResolution

Especifica o valor, como uma cadeia de caracteres, que representa a resolução máxima possível de monitor de um adaptador de vídeo virtual. Os valores aceitáveis para esse parâmetro são:

  • 1024 x 768
  • 1280x1024
  • 1600 x 1200
  • 1920x1200

O valor padrão é 1280x1024.

Formato de exemplo: -MonitorMaximumResolution "1600x1200"

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

-Name

Especifica o nome de um objeto VMM.

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

-NetworkUtilizationMbps

Especifica, em megabits por segundo (Mbps), a quantidade de largura de banda na rede do host que pode ser usada por uma máquina virtual específica.

Formato de exemplo: -NetworkUtilization 10

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

-NumaIsolationRequired

Indica se o isolamento NUMA é necessário.

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

-NumLock

Indica se é necessário habilitar o valor do BIOS para NumLock em um modelo usado para criar máquinas virtuais em um host Hyper-V. Esse parâmetro não se aplica a máquinas virtuais em hosts VMware ESX ou em hosts Citrix XenServer.

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

-OperatingSystem

Especifica o tipo de sistema operacional de uma máquina virtual. Para listar os nomes de todos os sistemas operacionais disponíveis no VMM, digite Get-SCOperatingSystem.

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

-OrganizationName

Especifica o nome da organização para a pessoa em cujo nome uma máquina virtual está registrada.

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

-Owner

Especifica o proprietário de um objeto do VMM na forma de uma conta de usuário de domínio válido.

  • Formato de exemplo: -Owner "Contoso\PattiFuller"
  • Formato de exemplo: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProductKey

Especifica uma chave do produto. A chave do produto é um número de 25 dígitos que identifica a licença do produto. Uma chave do produto pode ser usada para registrar o VMM ou um sistema operacional a ser instalado em uma máquina virtual ou host.

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

-ProtectionProvider

Especifica um provedor de proteção.

Type:ProtectionProvider
Accepted values:None, HVR8, HVRBlue, HVRAzure, DiskReplication, SANReplication
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

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

-QuotaPoint

Especifica uma cota que limita o número de máquinas virtuais que os usuários de autoatendimento podem implantar.

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

-RecoveryPointObjective

Especifica o período máximo para o qual é tolerável perder dados de um serviço de TI devido a um incidente importante.

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

-RemoveCapabilityProfile

Remove um ou mais objetos de perfil de funcionalidade especificados.

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

-RemoveDomainJoinOrganizationalUnit

Indica que esse cmdlet remove a unidade organizacional que o computador ingressou durante a instalação.

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

-RemoveServerFeatures

Indica que esse cmdlet remove todas as funções de servidor e recursos de um modelo.

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

-ReplicationGroup

Especifica um grupo de replicação.

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.

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

-SecureBootEnabled

Indica se a inicialização segura está habilitada.

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

-SecureBootTemplate

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

-SQLProfile

Especifica um objeto de perfil SQL Server.

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

-Tag

Especifica uma palavra ou frase a ser associada a um objeto para que você possa pesquisar todos os objetos com o conjunto de marcas especificado. Você pode pesquisar um subconjunto de marcas ou pesquisar o conjunto completo de marcas.

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

-TimeZone

Especifica um número (um índice) que identifica uma região geográfica que compartilha o mesmo tempo padrão. Para obter uma lista de índices de fuso horário, consulte os valores de índice de fuso horário da Microsoft em http://go.microsoft.com/fwlink/?LinkId=120935. Se nenhum fuso horário for especificado, o fuso horário padrão usado para uma máquina virtual será a mesma configuração de fuso horário que está no host da máquina virtual.

Formato de exemplo para especificar o fuso horário padrão GMT: -TimeZone 085

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

-UnattendSettings

Especifica um par chave/valor que consiste em Cadeia de Caracteres, Cadeia de Caracteres.

Type:System.Collections.Generic.Dictionary`2[System.String,System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpdateManagementProfile

Especifica o perfil do azure que pode ser usado no VMTemplate. O perfil do Azure fornece recursos de cogerenciamento do Azure para a VM.

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

-UserRole

Especifica um objeto de função de usuário.

Type:UserRole
Aliases:SelfServiceUserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNumaNodesPerSocketMaximum

Especifica o número máximo de nós NUMA permitidos para cada soquete.

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

-VirtualVideoAdapterEnabled

Indica se o Adaptador de Vídeo Virtual Do Microsoft Synthetic 3D deve ser habilitado para máquinas virtuais. Você pode habilitar o Adaptador de Vídeo Virtual diretamente em uma máquina virtual ou em um modelo ou perfil de hardware que será usado para criar máquinas virtuais.

Obrigatório: você pode habilitar o Adaptador de Vídeo Virtual Do Microsoft Synthetic 3D para uma máquina virtual somente se essa máquina virtual for implantada em um host executando o Windows Server 2008 R2 SP1 (com a função Serviços de Área de Trabalho Remota e o serviço de função gráficos virtuais de área de trabalho remota instalado) ou posterior ou se a máquina virtual estiver armazenada em uma biblioteca em um estado parado (alterações de hardware em uma máquina virtual armazenada só poderão ser feitas se a máquina virtual estiver armazenada em um estado parado (alterações de hardware em uma máquina virtual armazenada só poderão ser feitas se a máquina virtual o computador não tem instantâneos). Habilitar o Adaptador de Vídeo Virtual Do Microsoft Synthetic 3D em uma máquina virtual armazenada em uma biblioteca limitará o posicionamento desse computador para hosts que executam o Windows Server 2008 R2 SP1 (com a função Serviços de Área de Trabalho Remota e o serviço de função gráficos virtuais de área de trabalho remota instalados) ou posterior.

Formato de exemplo: -VirtualVideoAdapterEnabled $True

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

-VMTemplate

Especifica um objeto de modelo do VMM usado para criar máquinas virtuais.

Type:Template
Aliases:Template
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Workgroup

Especifica em um modelo novo ou existente, em um perfil de sistema operacional convidado novo ou existente, ou em uma nova máquina virtual o nome do grupo de trabalho ao qual você deseja ingressar em uma máquina virtual. Você pode usar esse parâmetro para substituir o valor existente em um modelo ou em um perfil do sistema operacional convidado.

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

Saídas

Template

Esse cmdlet retorna um objeto Template .

Observações

  • Requer um objeto de modelo de máquina virtual do VMM, que pode ser recuperado usando o cmdlet Get-SCVMTemplate .