Partilhar via


Set-SCVMTemplate

Altera as propriedades de um modelo de máquina virtual utilizado 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

Nota

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

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

As propriedades que pode alterar incluem definições para o nome do modelo, a respetiva descrição, proprietário, nome da organização, fuso horário, sistema operativo e chave de produto; Ordem de arranque do BIOS; Número e características da CPU; a quantidade de memória no anfitrião que está atribuída a uma máquina virtual; a quantidade de largura de banda na rede do anfitrião disponível para uma máquina virtual; se uma máquina virtual criada com este modelo estará altamente disponível (ou seja, implementada num anfitrião que faça parte de um cluster anfitrião); valores para domínio ou grupo de trabalho, bem como credenciais de domínio; uma quota de ponto que especifica o número de novas máquinas virtuais que os utilizadores self-service podem criar; campos personalizados; e outras opções.

As alterações efetuadas a um modelo afetam apenas o modelo. As alterações não afetam as máquinas virtuais existentes que foram criadas anteriormente com este modelo.

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

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 com o nome VMTemplate01 a partir da biblioteca do VMM e armazena o objeto na variável $Template.

O segundo comando altera o valor de memória de VMTemplate01 para 1024 MB. Esta é a quantidade de memória no anfitrião que uma máquina virtual criada com este modelo irá utilizar.

Exemplo 2: Especificar um novo proprietário para vários modelos de máquinas virtuais de elevada disponibilidade

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 de elevada disponibilidade e armazena os objetos na matriz de objetos $VMTemplates.

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

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

Exemplo 3: especifique um novo proprietário para todos os modelos de máquina virtual que tenham o mesmo proprietário

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

Este 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, transmite cada objeto para o cmdlet Set-SCVMTemplate , que altera o proprietário para Contoso|AllieSloan.

Exemplo 4: Ativar a 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 com o nome VMTemplate04 da biblioteca do VMM e armazena o objeto na variável $VMTemplate.

O segundo comando ativa a memória dinâmica, altera o valor de memória de arranque de VMTemplate04 para 1024 MB (esta é a quantidade de memória no anfitrião que uma máquina virtual criada com este modelo é alocada após o arranque) e define o valor máximo de memória para 2048 MB (esta é a quantidade máxima de memória que pode ser alocada a uma máquina virtual criada com este modelo). Uma máquina virtual que utilize memória dinâmica só pode ser implementada num anfitrião com o Windows Server 2008 R2 SP1 ou posterior.

Exemplo 5: especifique a palavra-passe de raiz para um modelo de máquina virtual do 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 com o nome LinuxVMTemplate01 da biblioteca do VMM e armazena o objeto na variável $Template.

O segundo comando obtém um nome de utilizador (raiz) e uma palavra-passe através do comando Get-Credential e armazena o resultado na variável $Creds.

O último comando define a palavra-passe da conta raiz para a palavra-passe armazenada na variável $Creds.

Exemplo 6: ativar as capacidades de gestão de atualizações do Azure num 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 com o nome VMTemplate01 a partir da biblioteca do VMM e armazena o objeto na variável $Template.

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

O terceiro comando ativa o modelo com as capacidades de gestão de atualizações do Azure ao ligar um perfil do Azure.

Exemplo 7: desativar as capacidades de gestão de atualizações do Azure num 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 com o nome VMTemplate01 a partir da biblioteca do VMM e armazena o objeto na variável $Template.

O segundo comando desativa o modelo com as capacidades de gestão de atualizações do Azure.

Parâmetros

-AnswerFile

Especifica um objeto de script armazenado na biblioteca do Virtual Machine Manager (VMM) para utilizar como um ficheiro de resposta. O nome do script de ficheiro de resposta depende do sistema operativo que pretende instalar numa 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 aplicação.

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 registar automaticamente o administrador indicado no Ficheiro de Resposta na sessão da consola.

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

-AutoLogonCredential

Especifica a conta Run As contida no ficheiro de resposta que o Windows utiliza para iniciar sessão na sessão da consola quando o início de sessão automático do administrador está ativado.

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

-AutomaticCriticalErrorAction

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

  • CD
  • IDEHardDrive
  • PXEBoot
  • Disquese
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
  • 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 este cmdlet repõe a opção de proteção contra recuperação após 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 na sua rede. Os valores aceitáveis para este 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 possa recolher dados sobre a alocação de máquinas virtuais (ou recursos alocados a máquinas virtuais) para utilizar no 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 numa máquina virtual, num perfil de hardware ou num modelo.

Os tipos de anfitriões suportam o seguinte número de CPUs:

  • Hyper-V. Até quatro CPUs por máquina virtual, dependendo do sistema operativo convidado.
  • VMware ESX. Até quatro CPUs por máquina virtual, mas apenas uma CPU numa máquina virtual que executa 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 pretende ativar a execução de 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, fornecendo funcionalidades de CPU limitadas 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 percentagem mais elevada do total de recursos de uma única CPU no anfitrião que pode ser utilizada por uma máquina virtual específica em qualquer altura.

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 da CPU num anfitrião que esta máquina virtual pode utilizar relativamente a outras máquinas virtuais no mesmo anfitrião. Uma máquina virtual com um valor de peso mais elevado é atribuída 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. 1 a 10000.
  • 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, normal é 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 a uma 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 uma lista de todos os tipos de CPU disponíveis para utilização em máquinas virtuais num ambiente do VMM, escreva Get-SCCPUType.

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

-Custom1

Especifica uma propriedade personalizada num 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 num 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 num 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 num 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 num 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 num 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 num 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 num 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 num 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 num 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

Desativa o início de sessão automático do administrador.

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 anfitrião que podem ser utilizadas 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 nome de domínio completamente qualificado (FQDN) 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 utilizador e a palavra-passe de uma conta que tem permissão para associar um computador ao domínio. Recomendamos que utilize uma conta de direitos limitada para associar computadores ao domínio. Isto inclui computadores virtuais e físicos.

Pode utilizar o parâmetro atual para especificar credenciais num VMHostProfile para associar um computador anfitrião físico ao domínio ou para especificar credenciais, num modelo novo ou existente, num perfil de sistema operativo convidado novo ou existente, ou numa nova máquina virtual, para associar uma máquina virtual ao 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 é associado durante uma miniconfiguração automática.

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

-DRProtectionRequired

Este parâmetro está reservado para utilização futura.

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

-DynamicMemoryBufferPercentage

Especifica a percentagem de memória acima da alocação de memória atual de uma máquina virtual que o anfitrião deve tentar reservar como memória intermédia. O valor predefinido é 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 pretende ativar a memória dinâmica para máquinas virtuais. Pode ativar a memória dinâmica diretamente numa máquina virtual ou num modelo ou perfil de hardware que é utilizado para criar máquinas virtuais. O valor predefinido é Falso.

Obrigatório: só pode ativar a memória dinâmica para uma máquina virtual se essa máquina virtual for implementada num anfitrião com o Windows Server 2008 SP1 ou posterior ou se a máquina virtual estiver armazenada numa biblioteca num estado parado (as alterações de hardware a uma máquina virtual armazenada só podem ser efetuadas se a máquina virtual não tiver instantâneos). Ativar a memória dinâmica numa máquina virtual armazenada numa biblioteca limita a colocação dessa máquina a anfitriões com 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 ativada. O valor predefinido é 65536.

Obrigatório: só pode ativar a memória dinâmica para uma máquina virtual se essa máquina virtual estiver implementada num anfitrião com o Windows Server 2008 R2 SP1 ou posterior ou se a máquina virtual estiver armazenada numa biblioteca num estado parado (as alterações de hardware a uma máquina virtual armazenada só podem ser efetuadas se a máquina virtual não tiver instantâneos). Ativar a memória dinâmica numa máquina virtual armazenada numa biblioteca limitará a colocação dessa máquina a anfitriões com 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 ativada. O valor predefinido é 65536.

Obrigatório: só pode ativar a memória dinâmica para uma máquina virtual se essa máquina virtual estiver implementada num anfitrião com o Windows Server 2008 R2 SP1 ou posterior ou se a máquina virtual estiver armazenada numa biblioteca num estado parado (as alterações de hardware a uma máquina virtual armazenada só podem ser efetuadas se a máquina virtual não tiver instantâneos). Ativar a memória dinâmica numa máquina virtual armazenada numa biblioteca limitará a colocação dessa máquina a anfitriões com 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

Ativa um objeto quando definido como $True ou desativa um objeto quando definido como $False. Por exemplo, se quiser atualizar o software num modelo de máquina virtual, pode desativar o objeto de modelo na biblioteca do VMM para impedir temporariamente os utilizadores de utilizarem esse objeto.

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

-EnableNestedVirtualization

Ativa a virtualização aninhada.

Nota

Este parâmetro é aplicável ao VMM 2019 UR1 e posterior.

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

-FirstBootDevice

Especifica o dispositivo no qual um arranque é tentado 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 está registada uma máquina virtual.

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

-GuiRunOnceCommands

Especifica uma matriz de comandos a adicionar à secção [GuiRunOnce] de um ficheiro de resposta automática. Utilize plicas à volta de cada cadeia 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 utiliza aspas, escreva 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 por ordem de prioridade até aos limites de um nó de cluster anfitrião. A entrada válida para este parâmetro é uma representação numérica da prioridade:

  • Elevada. 3.000
  • Média. 2000
  • Baixo. 1000

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

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

-HighlyAvailable

Indica se deve colocar uma máquina virtual num anfitrião Hyper-V que faça parte de um cluster anfitrião. Configure esta definição numa máquina virtual ou num modelo ou perfil de hardware que será utilizado 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 imediatamente antes do comando final que inclui a mesma execução do identificador do grupo de tarefas.

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

-JobVariable

Especifica que o progresso da tarefa é controlado e armazenado na variável denominada por este parâmetro.

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

-LinuxAdministratorSSHKey

Especifica o ficheiro 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 de administrador do Linux como uma cadeia.

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

-LinuxDomainName

Especifica um nome de domínio completamente qualificado (FQDN) a utilizar em conjunto com a especialização do sistema operativo 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 utilizador e a palavra-passe da conta de Administrador Local (ou conta de raiz do Linux no caso de um perfil do Sistema Operativo Convidado compatível com Linux).

Especificar credenciais num modelo novo ou existente, num perfil de sistema operativo convidado novo ou existente ou numa nova máquina virtual substitui qualquer palavra-passe 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 anfitrião que este cmdlet atribui à máquina virtual convertida. O valor predefinido é 512 MB. Para uma máquina virtual na qual a memória dinâmica está ativada num anfitrião que executa o Windows Server 2008 R2 SP1 ou versões posteriores, especifique o valor da memória de arranque.

Os tipos de anfitriões têm a seguinte memória máxima 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 a uma máquina virtual, relativamente a outras máquinas virtuais no mesmo anfitrião. Uma máquina virtual com uma definição mais alta é atribuída mais recursos de memória do que uma máquina virtual com uma definição mais baixa.

Para um anfitrião com 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 este cmdlet intercala o ficheiro de resposta juntamente com as definições do sistema operativo convidado. O valor predefinido é $True. A consola do VMM utiliza este parâmetro. Não especifique este 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 suportados por 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, que representa a resolução máxima possível de um adaptador de vídeo virtual. Os valores aceitáveis para este parâmetro são:

  • 1024x768
  • 1280x1024
  • 1600x1200
  • 1920x1200

O valor predefinido é 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 anfitrião que pode ser utilizada 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 pretende ativar o valor BIOS para o NumLock num modelo que é utilizado para criar máquinas virtuais num anfitrião Hyper-V. Este parâmetro não se aplica a máquinas virtuais em anfitriões VMware ESX ou em anfitriões 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 operativo para uma máquina virtual. Para listar os nomes de todos os sistemas operativos disponíveis no VMM, escreva 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 está registada uma máquina virtual.

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 sob a forma de uma conta de utilizador de domínio válida.

  • 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 de produto. A chave de produto é um número de 25 dígitos que identifica a licença de produto. Uma chave de produto pode ser utilizada para registar o VMM ou um sistema operativo a instalar numa máquina virtual ou num anfitrião.

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

-ProtectionProvider

Especifica um fornecedor 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 o ID da sugestão desempenho e Otimização de Recursos (sugestão PRO) que acionou esta ação. Este parâmetro permite-lhe auditar sugestões PRO.

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

-QuotaPoint

Especifica uma quota que limita o número de máquinas virtuais que os utilizadores self-service podem implementar.

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 grave.

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 capacidade especificados.

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

-RemoveDomainJoinOrganizationalUnit

Indica que este cmdlet remove a unidade organizacional que o computador juntou durante a configuração.

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

-RemoveServerFeatures

Indica que este cmdlet remove todas as funções e funcionalidades do servidor 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 a tarefa é executada de forma assíncrona para que o controlo regresse imediatamente à shell de comandos.

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

-SecureBootEnabled

Indica se o arranque seguro está ativado.

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 expressão a associar a um objeto para que possa procurar todos os objetos com o conjunto especificado de etiquetas. Pode procurar um subconjunto de etiquetas ou procurar o conjunto completo de etiquetas.

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 partilha a mesma hora padrão. Para obter uma lista de índices de fuso horário, veja Valores do Índice de Fuso Horário da Microsoft em http://go.microsoft.com/fwlink/?LinkId=120935. Se não for especificado nenhum fuso horário, o fuso horário predefinido utilizado para uma máquina virtual é a mesma definição de fuso horário que se encontra no anfitrião 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 composto por Cadeia, Cadeia.

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 utilizado em VMTemplate. O perfil do Azure fornece capacidades de cogestão do Azure à 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 utilizador.

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 socket.

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

-VirtualVideoAdapterEnabled

Indica se pretende ativar o Microsoft Synthetic 3D Virtual Video Adapter para máquinas virtuais. Pode ativar o Virtual Video Adapter diretamente numa máquina virtual ou num modelo ou perfil de hardware que será utilizado para criar máquinas virtuais.

Obrigatório: pode ativar o Microsoft Synthetic 3D Virtual Video Adapter para uma máquina virtual apenas se essa máquina virtual for implementada num anfitrião com o Windows Server 2008 R2 SP1 (com a função Serviços de Ambiente de Trabalho Remoto e o serviço de função Gráficos Virtuais de Ambiente de Trabalho Remoto instalado) ou posterior ou se a máquina virtual estiver armazenada numa biblioteca num estado parado (as alterações de hardware a uma máquina virtual armazenada só podem ser efetuadas se a máquina virtual for armazenada o computador não tem instantâneos). Ativar o Microsoft Synthetic 3D Virtual Video Adapter numa máquina virtual armazenada numa biblioteca limitará a colocação dessa máquina a anfitriões com o Windows Server 2008 R2 SP1 (com a função Serviços de Ambiente de Trabalho Remoto e o serviço de função Gráficos Virtuais de Ambiente de Trabalho Remoto instalado) 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 utilizado 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 num modelo novo ou existente, num perfil de sistema operativo convidado novo ou existente ou numa nova máquina virtual o nome do grupo de trabalho ao qual pretende aderir a uma máquina virtual. Pode utilizar este parâmetro para substituir o valor existente num modelo ou num perfil do sistema operativo convidado.

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

Saídas

Template

Este cmdlet devolve um objeto Modelo .

Notas

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