Set-SCVirtualMachine

Referencia

Módulo:: VirtualMachineManager

Cambia las propiedades de una máquina virtual administrada por VMM.

Syntax

Set-SCVirtualMachine
   [-VM] <VM>
   [-VMwareResourcePool <VmwResourcePool>]
   [-StartAction <VMStartAction>]
   [-StopAction <VMStopAction>]
   [-RemoveSelfServiceUserRole <Boolean>]
   [-EnableOperatingSystemShutdown <Boolean>]
   [-EnableTimeSync <Boolean>]
   [-EnableDataExchange <Boolean>]
   [-EnableHeartbeat <Boolean>]
   [-EnableBackup <Boolean>]
   [-InstallVirtualizationGuestServices <Boolean>]
   [-Owner <String>]
   [-OperatingSystem <OperatingSystem>]
   [-Enabled <Boolean>]
   [-HighlyAvailable <Boolean>]
   [-HAVMPriority <UInt32>]
   [-DRProtectionRequired <Boolean>]
   [-ReplicationGroup <ReplicationGroup>]
   [-SecureBootEnabled <Boolean>]
   [-NumLock <Boolean>]
   [-CPULimitFunctionality <Boolean>]
   [-CPULimitForMigration <Boolean>]
   [-VMShieldingData <KeyFile>]
   [-RunAsSystem]
   [-RunAsUserCredential <PSCredential>]
   [-DelayStartSeconds <Int32>]
   [-UseHardwareAssistedVirtualization <Boolean>]
   [-Cloud <Cloud>]
   [-CapabilityProfile <CapabilityProfile>]
   [-RemoveCapabilityProfile]
   [-RemoveFromCloud]
   [-ClusterNonPossibleOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-ClusterPreferredOwner <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]>]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-UserRole <UserRole>]
   [-Name <String>]
   [-JobGroup <Guid>]
   [-QuotaPoint <UInt32>]
   [-CostCenter <String>]
   [-Tag <String>]
   [-Custom1 <String>]
   [-Custom2 <String>]
   [-Custom3 <String>]
   [-Custom4 <String>]
   [-Custom5 <String>]
   [-Custom6 <String>]
   [-Custom7 <String>]
   [-Custom8 <String>]
   [-Custom9 <String>]
   [-Custom10 <String>]
   [-BlockDynamicOptimization <Boolean>]
   [-ClearDRProtection]
   [-Description <String>]
   [-MemoryMB <Int32>]
   [-DynamicMemoryEnabled <Boolean>]
   [-DynamicMemoryMaximumMB <Int32>]
   [-DynamicMemoryBufferPercentage <Int32>]
   [-MemoryWeight <Int32>]
   [-VirtualVideoAdapterEnabled <Boolean>]
   [-MonitorMaximumCount <Int32>]
   [-MonitorMaximumResolution <String>]
   [-RecoveryPointObjective <Int32>]
   [-ProtectionProvider <ProtectionProvider>]
   [-BootOrder <BootDevice[]>]
   [-FirstBootDevice <String>]
   [-SecureBootTemplate <String>]
   [-CPUCount <Byte>]
   [-CPUType <ProcessorType>]
   [-CPUExpectedUtilizationPercent <Int32>]
   [-DiskIops <Int32>]
   [-NetworkUtilizationMbps <Int32>]
   [-CPURelativeWeight <Int32>]
   [-CPUReserve <Int32>]
   [-CPUMaximumPercent <Int32>]
   [-CPUPerVirtualNumaNodeMaximum <Byte>]
   [-MemoryPerVirtualNumaNodeMaximumMB <Int32>]
   [-VirtualNumaNodesPerSocketMaximum <Byte>]
   [-DynamicMemoryMinimumMB <Int32>]
   [-NumaIsolationRequired <Boolean>]
   [-AutomaticCriticalErrorAction <UInt16>]
   [-AutomaticCriticalErrorActionTimeout <Int32>]
   [-CheckpointType <CheckpointType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

El cmdlet Set-SCVirtualMachine cambia las propiedades de una máquina virtual administrada por Virtual Machine Manager (VMM).

Las propiedades que puede cambiar incluyen lo siguiente:

Asocie una máquina virtual a una nube.
Nombre, propietario y descripción de una máquina virtual.
Orden de arranque del BIOS, si la máquina virtual se implementa en un host de Hyper-V.
Cantidad de recursos en el host usado por una máquina virtual. Entre ellas, figuran:
Cantidad máxima de recursos de CPU de host que puede usar una máquina virtual.
Se esperaba el uso de la CPU del host por una máquina virtual.
Cantidad de recursos de CPU de host usados por una máquina virtual en relación con otras máquinas virtuales en el mismo host.
Cantidad de memoria de host que puede usar una máquina virtual.
Cantidad de ancho de banda en la red del host que puede usar una máquina virtual.
Configuración de hardware de una máquina virtual no relacionada con los recursos de host. Entre ellas, figuran:
Número de CPU.
Tipo de CPU.
Número de operaciones de entrada y salida de disco por segundo (IOPS).
Limitar la funcionalidad de CPU para un sistema operativo anterior, como Windows NT 4.0.
Centro de costos, etiqueta y configuración personalizada que se usan para filtrar las máquinas virtuales por criterios.
Configuración que habilita varias funcionalidades opcionales, entre las que se incluyen las siguientes:
Habilitar o deshabilitar un objeto de biblioteca para que esté disponible o no esté disponible temporalmente para los usuarios.
Habilitación de la copia de seguridad de una máquina virtual en un host de Hyper-V con el servicio de instantáneas de volumen.
Habilitación de un par clave-valor para el intercambio de datos entre una máquina virtual y su host de Hyper-V.
Habilitación del apagado de una máquina virtual desde la consola de Hyper-V.
Habilitación de la sincronización de hora entre una máquina virtual y su host de Hyper-V.
Habilitación del valor del BIOS para NumLock para una máquina virtual en un host de Hyper-V.
Configuración que identifica si una máquina virtual es de alta disponibilidad, es decir, una máquina virtual que se va a implementar en un nodo de un clúster de hosts de Hyper-V o en un clúster de hosts de Citrix XenServer.
Configuración que determina si los servicios invitados de virtualización están instalados en una máquina virtual implementada en un host de Hyper-V.
Número de segundos que se van a retrasar antes de iniciar una máquina virtual.
Configuración que identifica el sistema operativo que se usa para una máquina virtual.
Inicie y detenga las acciones de una máquina virtual.
Establecer que limita el número de máquinas virtuales que los usuarios de autoservicio pueden crear.
Configuración usada para cambiar el rol que un usuario de autoservicio que pertenece a varios roles usa para administrar una máquina virtual.
Establecer que asigna una máquina virtual en un host ESX a un grupo de recursos de VMware.

Si desea cambiar las propiedades de una unidad de disquete virtual, una unidad de DVD virtual, un adaptador de red virtual o un adaptador SCSI virtual asociado a una máquina virtual específica, use el cmdlet Set-SCVirtualFloppyDrive, Set-SCVirtualDVDDrive, Set-SCVirtualNetworkAdapter o Set-SCVirtualScsiAdapter .

Ejemplos

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

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> If($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -MemoryMB 1024

El primer comando obtiene el objeto de máquina virtual denominado VM01 y, a continuación, almacena ese objeto en la variable $VM.

El segundo determina si la máquina virtual almacenada en $VM está en un estado apagado. Si la máquina virtual no está en estado apagado, el comando usa el comando Stop-SCVirtualMachine para apagar la máquina virtual. Para obtener más información sobre cómo apagar una máquina virtual, escriba Get-Help Stop-SCVirtualMachine.

El último comando cambia la memoria asignada a VM01 a 1024 MB.

Ejemplo 2: Cambio del rol de usuario que se usa para administrar una máquina virtual para un usuario que pertenece a varios roles de usuario de autoservicio

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" -Name "VM02"
PS C:\> $SSRole = Get-SCUserRole -Name "ContosoSelfServiceUsers"
PS C:\> Set-SCVirtualMachine -VM $VM -UserRole $SSRole

El primer comando obtiene el objeto de máquina virtual denominado VM02 de VMMServer01 y, a continuación, almacena ese objeto en la variable $VM.

El segundo comando obtiene el objeto de rol de usuario denominado ContosoSelfServiceUsers y, a continuación, almacena el objeto en la variable $SSRole.

El último comando especifica que a los miembros del rol de usuario de autoservicio llamado SSUserRole3 ahora se les concede el permiso para administrar la máquina virtual denominada VM02.

Nota: VMM usa el parámetro UserRole para establecer qué máquinas virtuales administran los miembros de un rol de usuario de autoservicio específico. Normalmente, no es necesario usar el cmdlet Set-SCVirtualMachine con el parámetro UserRole para configurar esta configuración. Sin embargo, si uno o varios usuarios son miembros de varios roles de usuario de autoservicio y les concede permiso para administrar varias máquinas virtuales en el mismo host, es posible que encuentre un caso en el que quiera cambiar el rol de usuario autorizado para administrar una máquina virtual determinada. Este ejemplo sirve para ilustrar ese escenario.

Ejemplo 3: Deshabilitar la sincronización de hora en una máquina virtual que se usa como controlador de dominio

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "STOP"
PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> trap{"Fail: Cannot disable Time Synchronization for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -EnableTimeSynchronization $TRUE | Out-Null
PS C:\> $ErrorActionPreference = $EAP

El primer comando almacena la configuración actual de $ErrorActionPreference en la variable $EAP. Esta variable se usa más adelante para devolver la configuración a su valor original.

El segundo comando establece la preferencia de acción en STOP. Esta preferencia de acción de error cambia un error de no finalización a otro de finalización. El objeto de error se genera como una excepción en lugar de escribirse en la canalización de salida y el comando no continúa ejecutándose.

El tercer comando obtiene el objeto de máquina virtual denominado VM03 y almacena ese objeto en la variable $VM.

El cuarto comando deshabilita la configuración de sincronización de hora. Normalmente, la deshabilitación de la sincronización de tiempo es necesaria para las máquinas virtuales que actúan como controladores de dominio. El comando usa la instrucción trap para detectar excepciones de terminación. Si se produce un error en el comando Set-SCVirtualMachine , se muestra la cadena de la instrucción trap . Continue se usa en la instrucción trap para continuar ejecutándose en lugar de salir. El cmdlet Out-Null redirige los resultados a $Null en lugar de enviarlos a la consola.

El último comando establece el valor de $ErrorActionPreference en el valor almacenado en $EAP.

Ejemplo 4: Establecimiento del orden de inicio del dispositivo para todas las máquinas virtuales que admiten esta característica

PS C:\> $EAP = $ErrorActionPreference
PS C:\> $ErrorActionPreference = "Stop"
PS C:\> $VMs = @(Get-SCVirtualMachine)
PS C:\> ForEach($VM in $VMs){trap{"Fail: Cannot set BIOS for VM: $VM";continue} Set-SCVirtualMachine -VM $VM -BootOrder "PXEBoot","IDEHarddrive","CD","Floppy" | Out-Null}
PS C:\> $ErrorActionPreference = $EAP

El primer comando almacena la configuración actual de $ErrorActionPreference en $EAP. Esta variable se usa más adelante para devolver la configuración a su valor original.

El segundo comando establece la preferencia de acción de error en Detener. Esta preferencia de acción de error cambia un error de no finalización a otro de finalización. El objeto de error se genera como una excepción en lugar de escribirse en la canalización de salida y el comando no continúa ejecutándose.

El tercer comando obtiene cada objeto de máquina virtual almacena los objetos en $VMs. El uso del símbolo @ y los paréntesis se asegura de que el comando almacena los resultados en una matriz en caso de que el comando devuelva un único objeto o un valor NULL.

El cuarto comando establece el orden de arranque del BIOS para cada máquina virtual en PXEBoot,IDEHarddrive,CD,Floppy. El comando usa una instrucción trap para detectar excepciones de terminación. Si se produce un error en el comando Set-SCVirtualMachine , se muestra la cadena de la instrucción trap. Continue se usa en la instrucción trap para continuar ejecutándose en lugar de salir del bucle ForEach . El cmdlet Out-Null redirige la salida a $Null en lugar de enviarlo a la consola.

Nota: El parámetro BootOrder solo se usa para máquinas virtuales en hosts de Hyper-V y Citrix XenServer. No se usa para máquinas virtuales en hosts de VMware ESX. Los hosts de XenServer no admiten discos de disquete y, por tanto, omite Floppy si aparecen en el orden de arranque.

El último comando establece el valor de $ErrorActionPreference en el valor almacenado en EAP.

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

Ejemplo 5: Especificar un propietario para todas las máquinas virtuales sin propietario

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

Este comando obtiene todos los objetos de máquina virtual en VMMServer01, selecciona solo los objetos de máquina virtual en los que no aparece ningún propietario y especifica un propietario para cada máquina virtual.

Ejemplo 6: Habilitación de la memoria dinámica para una máquina virtual existente

PS C:\> $VM = Get-SCVirtualMachine -Name "VM06"
PS C:\> if($VM.Status -ne "PowerOff"){Stop-SCVirtualMachine -VM $VM}
PS C:\> Set-SCVirtualMachine -VM $VM -DynamicMemoryEnabled $True -MemoryMB 1024 -DynamicMemoryMaximumMB 2048

El primer comando obtiene el objeto de máquina virtual VM06 y almacena ese objeto en la variable $VM. Para habilitar la memoria dinámica en una máquina virtual, la máquina virtual debe residir en un host que ejecute Windows Server 2008 R2 SP1 o una versión posterior.

El segundo comando determina si la máquina virtual almacenada en $VM está en un estado apagado. Si la máquina virtual no está en un estado apagado, el comando usa el comando Stop-SCVirtualMachine para apagar la máquina virtual.

El último comando habilita memoria dinámica, establece la memoria de inicio en 1024 MB y establece la memoria máxima en 2048 MB. La memoria de inicio es la cantidad de memoria en el host que se asigna a VM06 al iniciarse. La memoria máxima es la cantidad máxima de memoria en el host que se asigna a VM06.

Parámetros

-AutomaticCriticalErrorAction

Especifica la acción que se debe realizar cuando la máquina virtual encuentra un error crítico y supera la duración del tiempo de espera especificado 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 debe 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

-AvailabilitySetNames

Especifica una lista de nombres de conjuntos de disponibilidad.

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

-BlockDynamicOptimization

Indica 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 una matriz, de los dispositivos que usa una máquina virtual en un host de Hyper-V. 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 control. 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 de datos.

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

-Cloud

Especifica un objeto de nube privada.

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

-ClusterNonPossibleOwner

Especifica una lista de nombres de los propietarios de nodos de clúster no posibles para una máquina virtual especificada.

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClusterPreferredOwner

Especifica una lista de nombres de los propietarios de nodos de clúster preferidos para una máquina virtual determinada.

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CostCenter

Especifica el centro de costos de una máquina virtual. Puede recopilar datos sobre la asignación de máquinas virtuales o recursos asignados a máquinas virtuales para 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 en la máquina virtual. Los hosts siguientes admiten el siguiente número de procesadores:

Hyper-V. Hasta cuatro CPU por máquina virtual, según el sistema operativo invitado.
VMware ESX. Hasta cuatro CPU por máquina virtual para cualquier sistema operativo invitado compatible, excepto una CPU en una máquina virtual que ejecuta Windows NT 4.0.
Citrix XenServer. Hasta ocho CPU por máquina virtual, según el 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 solo 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 debe proporcionar una funcionalidad limitada de CPU para la máquina virtual. Especifique un valor de $True para admitir 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.

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

-CPUMaximumPercent

Especifica el porcentaje más alto de los recursos totales de una sola CPU en el host que una máquina virtual puede usar al mismo tiempo.

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. A una máquina virtual con un valor de peso mayor se le asignan 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, el típico 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 en el host que se va a asignar a la 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 obtener todos los tipos de CPU que están disponibles para su uso en máquinas virtuales en un entorno VMM, consulte el cmdlet Get-SCCPUType .

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