Set-SCVMTemplate

Cambia las propiedades de una plantilla de máquina virtual usada en 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

Un nuevo parámetro [-EnableNestedVirtualization] <Boolean> se incluye en VMM 2019 UR1 y versiones posteriores. Para obtener más información, vea Parámetros.

El cmdlet Set-SCVMTemplate cambia una o varias propiedades de una plantilla de máquina virtual usada en un entorno de Virtual Machine Manager (VMM).

Las propiedades que puede cambiar incluyen la configuración del nombre de la plantilla, su descripción, propietario, nombre de la organización, zona horaria, sistema operativo y clave de producto; Orden de arranque del BIOS; Número de CPU y características; la cantidad de memoria en el host que se asigna a una máquina virtual; la cantidad de ancho de banda en la red del host disponible para una máquina virtual; si una máquina virtual creada con esta plantilla estará altamente disponible (es decir, implementada en un host que forme parte de un clúster de hosts); valores de dominio o grupo de trabajo, así como credenciales de dominio; una cuota de punto que especifica cuántos usuarios de autoservicio pueden crear nuevas máquinas virtuales; campos personalizados; y otras opciones.

Los cambios realizados en una plantilla sólo afectan a la plantilla. Los cambios no afectan a las máquinas virtuales existentes que se crearon anteriormente mediante esta plantilla.

Si desea cambiar las propiedades de una unidad de disco virtual, Unidad de disquete virtual, unidad de DVD virtual, adaptador de red virtual, adaptador SCSI virtual o puerto COM virtual asociado a una plantilla específica, puede usar Set-SCVirtualDiskDrive, Set-SCVirtualFloppyDrive, Set-SCVirtualDVDDrive, Set-SCVirtualNetworkAdapter, Set-SCVirtualScsiAdapter o cmdlets Set-SCVirtualCOMPort , respectivamente.

Ejemplos

Ejemplo 1: Especificar una cantidad de memoria para una plantilla de máquina virtual existente

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

El primer comando obtiene el objeto de plantilla de máquina virtual denominado VMTemplate01 de la biblioteca VMM y almacena el objeto en la variable $Template.

El segundo comando cambia el valor de memoria de VMTemplate01 a 1024 MB. Esta es la cantidad de memoria en el host que usará una máquina virtual creada mediante esta plantilla.

Ejemplo 2: Especificar un nuevo propietario para varias plantillas de máquina virtual de alta disponibilidad

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

El primer comando obtiene todos los objetos de plantilla de máquina virtual de alta disponibilidad y almacena los objetos en la matriz de objetos $VMTemplates.

El segundo comando usa un bucle ForEach para especificar un nuevo propietario para cada una de las plantillas de la matriz $VMTemplates.

Para obtener información sobre la instrucción de bucle ForEach de PowerShell estándar, escriba Get-Help about_ForEach.

Ejemplo 3: Especificar un nuevo propietario para todas las plantillas de máquina virtual que tengan el mismo propietario

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

Este comando obtiene todos los objetos de plantilla de máquina virtual de la biblioteca VMM, selecciona solo los objetos cuyo propietario es "Contoso\PattiFuller" y, a continuación, pasa cada objeto al cmdlet Set-SCVMTemplate , que cambia el propietario a Contoso|AllieSloan.

Ejemplo 4: Habilitación de la memoria dinámica para una plantilla 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

El primer comando obtiene el objeto de plantilla de máquina virtual denominado VMTemplate04 de la biblioteca VMM y almacena el objeto en la variable $VMTemplate.

El segundo comando habilita la memoria dinámica, cambia el valor de memoria de inicio de VMTemplate04 a 1024 MB (esta es la cantidad de memoria en el host que una máquina virtual creada con esta plantilla se asigna al inicio) y establece el valor máximo de memoria en 2048 MB (es la cantidad máxima de memoria que se puede asignar a una máquina virtual creada mediante esta plantilla). Una máquina virtual que usa memoria dinámica solo se puede implementar en un host que ejecute Windows Server 2008 R2 SP1 o posterior.

Ejemplo 5: Especificación de la contraseña raíz de una plantilla de máquina virtual Linux personalizable

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

El primer comando obtiene el objeto de plantilla de máquina virtual denominado LinuxVMTemplate01 de la biblioteca VMM y almacena el objeto en la variable $Template.

El segundo comando obtiene un nombre de usuario (raíz) y una contraseña a través del comando Get-Credential y almacena el resultado en la variable $Creds.

El último comando establece la contraseña de la cuenta raíz en la contraseña almacenada en la variable $Creds.

Ejemplo 6: Habilitación de las funcionalidades de administración de actualizaciones de Azure en una plantilla de máquina virtual 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

El primer comando obtiene el objeto de plantilla de máquina virtual denominado VMTemplate01 de la biblioteca VMM y almacena el objeto en la variable $Template.

El segundo comando obtiene un perfil de administración de actualizaciones de Azure de la biblioteca VMM y almacena el objeto en la variable $azureProfile.

El tercer comando habilita la plantilla con funcionalidades de administración de actualizaciones de Azure mediante la vinculación de un perfil de Azure.

Ejemplo 7: Deshabilitación de las funcionalidades de administración de actualizaciones de Azure en una plantilla de máquina virtual.

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

El primer comando obtiene el objeto de plantilla de máquina virtual denominado VMTemplate01 de la biblioteca VMM y almacena el objeto en la variable $Template.

El segundo comando deshabilita la plantilla con las funcionalidades de administración de actualizaciones de Azure.

Parámetros

-AnswerFile

Especifica un objeto de script almacenado en la biblioteca de Virtual Machine Manager (VMM) que se va a usar como archivo de respuesta. El nombre del script del archivo de respuesta depende del sistema operativo que desea instalar en una máquina virtual:

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

-ApplicationProfile

Especifica un objeto de perfil de aplicación.

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

-AutoLogonCount

Especifica el número de veces que Windows debería registrar automáticamente al administrador indicado en el archivo de respuesta en la sesión de consola.

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

-AutoLogonCredential

Especifica la cuenta de ejecución contenida en el archivo de respuesta que Windows usa para iniciar sesión en la sesión de consola cuando se habilita el inicio de sesión de administrador automático.

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

-AutomaticCriticalErrorAction

Especifica la acción que se debe realizar cuando la máquina virtual encuentra un error crítico y supera la duración de tiempo de espera especificada por el parámetro AutomaticCriticalErrorActionTimeout . Los valores aceptables para este parámetro son: Pause y None.

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

-AutomaticCriticalErrorActionTimeout

Especifica la cantidad de tiempo, en minutos, que se esperará en pausa crítica antes de apagar la máquina virtual.

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

-BlockDynamicOptimization

Indica si la optimización dinámica está bloqueada para una máquina virtual.

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

-BootOrder

Especifica el orden, como matriz, de dispositivos que usa una máquina virtual en un host de Hyper-V para iniciarse. Los valores válidos son:

  • CD
  • IDEHardDrive
  • PXEBoot
  • Disquete
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 un objeto de perfil de funcionalidad.

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

-CheckpointType

Especifica el tipo de punto de comprobación. Los valores permitidos para este parámetro son los siguientes:

  • Disabled
  • Producción
  • ProductionOnly
  • Estándar
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 restablece la opción de protección de recuperación ante desastres.

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

-ComputerName

Especifica el nombre de un equipo que VMM puede identificar de forma única en su red. Los valores permitidos para este parámetro son los siguientes:

  • FQDN
  • Dirección IPv4 o IPv6
  • Nombre de NetBIOS
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CostCenter

Especifica el centro de costo de una máquina virtual para poder recopilar datos sobre la asignación de máquinas virtuales (o recursos asignados a máquinas virtuales), que puede usar en el sistema de facturación.

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

-CPUCount

Especifica el número de CPU de una máquina virtual, un perfil de hardware o una plantilla.

Los tipos de hosts admiten el siguiente número de CPU:

  • Hyper-V. Hasta cuatro CPU por máquina virtual, en función del sistema operativo invitado.
  • VMware ESX. Hasta cuatro CPU por máquina virtual, pero solo una CPU en una máquina virtual que ejecuta Windows NT 4.0.
  • Citrix XenServer. Hasta ocho CPU por máquina virtual, dependiendo del sistema operativo invitado.
Type:Byte
Aliases:ProcessorCount
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CPUExpectedUtilizationPercent

Especifica el porcentaje de CPU en el host que espera que use esta máquina virtual. Este valor sólo se usa cuando VMM determina un host adecuado para la máquina virtual.

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

-CPULimitForMigration

Indica si se deben limitar las características del procesador de la máquina virtual especificada para habilitar la migración a un equipo físico que tenga una versión diferente del mismo procesador que el equipo de origen. VMM no admite la migración de máquinas virtuales entre equipos físicos con procesadores de fabricantes distintos.

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

-CPULimitFunctionality

Indica si se va a habilitar la ejecución de un sistema operativo anterior, como Windows NT 4.0, en una máquina virtual implementada en un host de Hyper-V o en un host de VMware ESX proporcionando una funcionalidad limitada de CPU para la máquina virtual.

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

-CPUMaximumPercent

Especifica el porcentaje máximo del total de recursos de una sola CPU del host que puede usar una máquina virtual específica en cualquier momento.

Ejemplo: -CPUMaximumPercent 80 (para especificar el 80 por ciento)

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

-CPUPerVirtualNumaNodeMaximum

Especifica el número máximo de CPU permitidas para cada nodo NUMA virtual.

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

-CPURelativeWeight

Especifica la cantidad de recursos de CPU de un host que puede usar esta máquina virtual en relación con otras máquinas virtuales del mismo host. Una máquina virtual con un valor de peso mayor se asigna más recursos de CPU que una máquina virtual con un valor de peso menor. El término de VMware para estos valores es recursos compartidos.

Los tipos de hosts admiten los siguientes valores relativos:

  • Hyper-V. De 1 a 10000.
  • VMware ESX. Alta. 2000.
  • VMware ESX. Por encima de normal. 1500.
  • VMware ESX. Normal (valor predeterminado). 1000.
  • VMware ESX. Por debajo de lo normal. 750.
  • VMware ESX. Baja. 500.
  • VMware ESX. Personalizado de 1 a 1000000.
  • Citrix XenServer. De 1 a 65536, normal es 256.
Type:Int32
Aliases:RelativeWeight
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CPUReserve

Especifica el porcentaje mínimo de los recursos de una sola CPU del host para asignar a una máquina virtual. El porcentaje de capacidad de la CPU disponible para la máquina virtual nunca será inferior a este porcentaje.

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

-CPUType

Especifica el tipo de CPU para una máquina virtual. Para recuperar una lista de todos los tipos de CPU que están disponibles para su uso en máquinas virtuales en un entorno VMM, escriba Get-SCCPUType.

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

-Custom1

Especifica una propiedad personalizada en una plantilla de máquina virtual.

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

-Custom10

Especifica una propiedad personalizada en una plantilla de máquina virtual.

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

-Custom2

Especifica una propiedad personalizada en una plantilla de máquina virtual.

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

-Custom3

Especifica una propiedad personalizada en una plantilla de máquina virtual.

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

-Custom4

Especifica una propiedad personalizada en una plantilla de máquina virtual.

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

-Custom5

Especifica una propiedad personalizada en una plantilla de máquina virtual.

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

-Custom6

Especifica una propiedad personalizada en una plantilla de máquina virtual.

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

-Custom7

Especifica una propiedad personalizada en una plantilla de máquina virtual.

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

-Custom8

Especifica una propiedad personalizada en una plantilla de máquina virtual.

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

-Custom9

Especifica una propiedad personalizada en una plantilla 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 una descripción para la plantilla de máquina virtual.

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

-DisableAutoLogon

Deshabilita el inicio de sesión automático del administrador.

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

-DiskIops

Especifica el número de operaciones de entrada/salida de disco por segundo (IOPS) en el host que puede usar una máquina virtual específica.

Ejemplo: -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 un nombre de dominio completo (FQDN) para un dominio de Active Directory.

Formato de ejemplo: -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 el nombre de usuario y la contraseña de una cuenta que tiene permiso para unir un equipo al dominio. Se recomienda usar una cuenta de derechos limitada que une equipos al dominio. Esto incluye equipos virtuales y físicos.

Puede usar el parámetro actual para especificar credenciales en un vmHostProfile para unir un equipo host físico al dominio, o para especificar credenciales, en una plantilla nueva o existente, en un perfil de sistema operativo invitado nuevo o existente, o en una nueva máquina virtual, para unir una máquina virtual al dominio.

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

-DomainJoinOrganizationalUnit

Especifica la unidad organizativa a la que se une el equipo durante una minicons setup desatendida.

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

-DRProtectionRequired

Este parámetro se reserva para uso futuro.

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

-DynamicMemoryBufferPercentage

Especifica el porcentaje de memoria por encima de la asignación de memoria actual de una máquina virtual que el host debe intentar reservar como búfer. El valor predeterminado es 20.

Formato de ejemplo: -DynamicMemoryTargetBufferPercentage 20

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

-DynamicMemoryEnabled

Indica si se va a habilitar la memoria dinámica para las máquinas virtuales. Puede habilitar la memoria dinámica directamente en una máquina virtual o en una plantilla o perfil de hardware que se usa para crear máquinas virtuales. El valor predeterminado es False.

Obligatorio: puede habilitar la memoria dinámica para una máquina virtual solo si esa máquina virtual se implementa en un host que ejecuta Windows Server 2008 SP1 o posterior, o si la máquina virtual se almacena en una biblioteca en un estado detenido (los cambios de hardware en una máquina virtual almacenada solo se pueden realizar si la máquina virtual no tiene instantáneas). Habilitar la memoria dinámica en una máquina virtual almacenada en una biblioteca limita la colocación de esa máquina en hosts que ejecutan Windows Server 2008 SP1 o posterior.

Formato de ejemplo: -DynamicMemoryEnabled $True

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

-DynamicMemoryMaximumMB

Especifica la cantidad máxima de memoria que se puede asignar a una máquina virtual si está habilitada la memoria dinámica. El valor predeterminado es 65536.

Obligatorio: puede habilitar la memoria dinámica para una máquina virtual solo si esa máquina virtual se implementa en un host que ejecuta Windows Server 2008 R2 SP1 o posterior, o si la máquina virtual se almacena en una biblioteca en estado detenido (solo se pueden realizar cambios de hardware en una máquina virtual almacenada si la máquina virtual no tiene instantáneas). La habilitación de la memoria dinámica en una máquina virtual almacenada en una biblioteca limitará la ubicación de dicha máquina en hosts que ejecuten Windows Server 2008 R2 SP1 o posterior.

Formato de ejemplo: -DynamicMemoryMaximumMB 1024

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

-DynamicMemoryMinimumMB

Especifica la cantidad mínima de memoria que se puede asignar a una máquina virtual si está habilitada la memoria dinámica. El valor predeterminado es 65536.

Obligatorio: puede habilitar la memoria dinámica para una máquina virtual solo si esa máquina virtual se implementa en un host que ejecuta Windows Server 2008 R2 SP1 o posterior, o si la máquina virtual se almacena en una biblioteca en estado detenido (solo se pueden realizar cambios de hardware en una máquina virtual almacenada si la máquina virtual no tiene instantáneas). La habilitación de la memoria dinámica en una máquina virtual almacenada en una biblioteca limitará la ubicación de dicha máquina en hosts que ejecuten Windows Server 2008 R2 SP1 o posterior.

Formato de ejemplo: -DynamicMemoryMinimumMB 1024

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

-Enabled

Habilita un objeto cuando se establece en $True o deshabilita un objeto cuando se establece en $False. Por ejemplo, si desea actualizar software en una plantilla de máquina virtual, puede deshabilitar el objeto de plantilla en la biblioteca VMM para impedir temporalmente que los usuarios utilicen dicho objeto.

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

-EnableNestedVirtualization

Habilita la virtualización anidada.

Nota

Este parámetro es aplicable a VMM 2019 UR1 y versiones posteriores.

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

-FirstBootDevice

Especifica el dispositivo en el que se intenta por primera vez un arranque.

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

-FullName

Especifica el nombre de la persona a cuyo nombre está registrada la máquina virtual.

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

-GuiRunOnceCommands

Especifica una matriz de comandos que se van a agregar a la sección [GuiRunOnce] de un archivo de respuesta desatendido. Use comillas simples alrededor de cada cadena entre comillas dobles.

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

Para obtener información sobre cómo Windows PowerShell usa comillas, escriba Get-Help about_Quoting_Rules.

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

-HAVMPriority

Especifica la prioridad de la máquina virtual. Las máquinas virtuales se inician en orden de prioridad hasta los límites de un nodo de clúster host. La entrada válida para este parámetro es una representación numérica de la prioridad:

  • Alta. 3000
  • Mediana. 2000
  • Baja. 1000

Si especifica un valor de cero (0), la máquina virtual no se reinicia automáticamente.

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

-HighlyAvailable

Indica si se va a colocar una máquina virtual en un host de Hyper-V que forma parte de un clúster de hosts. Configure este valor en una máquina virtual, o bien, en una plantilla o un perfil de hardware que se usará para crear máquinas virtuales.

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

-JobGroup

Especifica un identificador para una serie de comandos que se ejecutan como un conjunto justo antes de que se ejecute el mismo identificador de grupo de trabajos.

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

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.

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

-LinuxAdministratorSSHKey

Especifica el archivo de clave pública para una clave SSH de Linux.

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

-LinuxAdministratorSSHKeyString

Especifica una clave SSH de administrador de Linux como una cadena.

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

-LinuxDomainName

Especifica un nombre de dominio completo (FQDN) que se usará junto con la especialización del sistema operativo Linux.

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

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

-LocalAdministratorCredential

Especifica el nombre de usuario y la contraseña de la cuenta de administrador local (o la cuenta raíz de Linux en el caso de un perfil de sistema operativo invitado compatible con Linux).

Especificar credenciales en una plantilla nueva o existente, en un perfil de sistema operativo invitado nuevo o existente, o en una nueva máquina virtual invalida cualquier contraseña de administrador existente.

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

-MemoryMB

Especifica la cantidad de memoria de acceso aleatorio (RAM), en megabytes (MB), en el host que este cmdlet asigna a la máquina virtual convertida. El valor predeterminado es 512 MB. Para una máquina virtual en la que está habilitada la memoria dinámica en un host que ejecuta Windows Server 2008 R2 SP1 o versiones posteriores, especifique el valor de memoria de inicio.

Los tipos de hosts tienen la memoria máxima siguiente asignable a las máquinas virtuales:

  • Hyper-V. Hasta 65536 MB de RAM por máquina virtual.
  • VMware ESX Server 3.0.x. Hasta 16384 MB de RAM por máquina virtual.
  • VMware ESX Server 3.5.x. Hasta 65532 MB de RAM por máquina virtual.
  • Citrix XenServer. Hasta 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 la cantidad máxima de memoria, en MB, que se permite cada nodo NUMA virtual.

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

-MemoryWeight

Indica la prioridad en la asignación de memoria a una máquina virtual, en relación con las otras máquinas virtuales en el mismo host. A las máquinas virtuales con un valor superior se les asignarán más recursos de memoria que a las máquinas virtuales con un valor inferior.

Para un host que ejecuta Windows Server 2008 R2 SP1 o posterior, 5000 = Normal, 10000 = Alto, 0 = Bajo, de 1 a 10000 = Personalizado.

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

-MergeAnswerFile

Indica si este cmdlet combina el archivo de respuesta junto con la configuración del sistema operativo invitado. El valor predeterminado es $True. La consola VMM usa este parámetro. No especifique este parámetro.

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

-MonitorMaximumCount

Especifica el número máximo de monitores que admite un adaptador de vídeo virtual.

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

-MonitorMaximumResolution

Especifica el valor, como una cadena, que representa la resolución de monitor máxima posible de un adaptador de vídeo virtual. Los valores permitidos para este parámetro son los siguientes:

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

El valor predeterminado es 1280x1024.

Formato de ejemplo: -MonitorMaximumResolution "1600x1200"

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

-Name

Especifica el nombre de un objeto de VMM.

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

-NetworkUtilizationMbps

Especifica, en megabits por segundo (Mbps), la cantidad de ancho de banda en la red del host que puede usar una máquina virtual específica.

Formato de ejemplo: -NetworkUtilization 10

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

-NumaIsolationRequired

Indica si se requiere aislamiento NUMA.

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

-NumLock

Indica si se habilita el valor del BIOS para NumLock en una plantilla que se usa para crear máquinas virtuales en un host de Hyper-V. Este parámetro no se aplica a las máquinas virtuales en hosts de VMware ESX ni en hosts de Citrix XenServer.

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

-OperatingSystem

Especifica el tipo de sistema operativo de una máquina virtual. Para enumerar los nombres de todos los sistemas operativos disponibles en VMM, escriba Get-SCOperatingSystem.

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

-OrganizationName

Especifica el nombre de la organización para la persona en cuyo nombre está registrada una máquina virtual.

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

-Owner

Especifica el propietario de un objeto de VMM en forma de cuenta de usuario de dominio válida.

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

-ProductKey

Especifica una clave de producto. La clave de producto es un número de 25 dígitos que identifica la licencia del producto. Se puede usar una clave de producto para registrar VMM o un sistema operativo que se va a instalar en una máquina virtual o host.

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

-ProtectionProvider

Especifica un proveedor de protección.

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 el identificador de la sugerencia de optimización de recursos y rendimiento (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias pro.

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

-QuotaPoint

Especifica una cuota que limita el número de máquinas virtuales que los usuarios de autoservicio pueden implementar.

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

-RecoveryPointObjective

Especifica el período máximo para el que es tolerable perder datos de un servicio de TI debido a un incidente importante.

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

-RemoveCapabilityProfile

Quita uno o varios objetos de perfil de funcionalidad especificados.

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

-RemoveDomainJoinOrganizationalUnit

Indica que este cmdlet quita la unidad organizativa que el equipo unido durante la instalación.

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

-RemoveServerFeatures

Indica que este cmdlet quita todos los roles y características de servidor de una plantilla.

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

-ReplicationGroup

Especifica un grupo de replicación.

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

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

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

-SecureBootEnabled

Indica si el arranque seguro está habilitado.

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 un objeto de perfil SQL Server.

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

-Tag

Especifica una palabra o frase que se va a asociar a un objeto para que pueda buscar todos los objetos con el conjunto de etiquetas especificado. Puede buscar un subconjunto de etiquetas o puede buscar el conjunto completo de etiquetas.

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

-TimeZone

Especifica un número (un índice) que identifica una región geográfica que comparte la misma hora estándar. Para obtener una lista de índices de zona horaria, vea Valores de índice de zona horaria de Microsoft en .http://go.microsoft.com/fwlink/?LinkId=120935 Si no se especifica ninguna zona horaria, la zona horaria predeterminada que se usa para una máquina virtual es la misma configuración de zona horaria que se encuentra en el host de máquina virtual.

Formato de ejemplo para especificar la zona horaria estándar GMT: -TimeZone 085

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

-UnattendSettings

Especifica un par clave-valor formado por String, String.

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 el perfil de Azure que se puede usar en VMTemplate. El perfil de Azure proporciona funcionalidades de administración conjunta de Azure a la máquina virtual.

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

-UserRole

Especifica un objeto de función de usuario.

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

-VirtualNumaNodesPerSocketMaximum

Especifica el número máximo de nodos NUMA permitidos para cada socket.

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

-VirtualVideoAdapterEnabled

Indica si se va a habilitar el adaptador de vídeo virtual 3D sintético de Microsoft para máquinas virtuales. Puede habilitar el adaptador de vídeo virtual directamente en una máquina virtual o en una plantilla o perfil de hardware que se usará para crear máquinas virtuales.

Obligatorio: puede habilitar el adaptador de vídeo virtual 3D de Microsoft Synthetic para una máquina virtual solo si esa máquina virtual se implementa en un host que ejecuta Windows Server 2008 R2 SP1 (con el rol Servicios de Escritorio remoto y el servicio de rol Gráficos virtuales de Escritorio remoto instalado) o posterior, o si la máquina virtual se almacena en una biblioteca en un estado detenido (los cambios de hardware en una máquina virtual almacenada solo se pueden realizar si la máquina virtual virtual está instalada) la máquina no tiene instantáneas). Al habilitar el adaptador de vídeo virtual 3D de Microsoft Synthetic en una máquina virtual almacenada en una biblioteca, se limitará la colocación de esa máquina a los hosts que ejecutan Windows Server 2008 R2 SP1 (con el rol Servicios de Escritorio remoto y el servicio de rol Gráficos virtuales de Escritorio remoto instalados) o posterior.

Formato de ejemplo: -VirtualVideoAdapterEnabled $True

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

-VMTemplate

Especifica un objeto de plantilla VMM usado para crear máquinas virtuales.

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

-Workgroup

Especifica en una plantilla nueva o existente, en un perfil de sistema operativo invitado nuevo o existente, o en una nueva máquina virtual el nombre del grupo de trabajo al que desea unirse a una máquina virtual. Puede usar este parámetro para invalidar el valor existente en una plantilla o un perfil del sistema operativo invitado.

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

Salidas

Template

Este cmdlet devuelve un objeto Template .

Notas

  • Requiere un objeto de plantilla de máquina virtual VMM, que se puede recuperar mediante el cmdlet Get-SCVMTemplate .