Set-SCVirtualMachine

Referencia

Módulo:: VirtualMachineManager

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

Sintaxis

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

Entre las propiedades que puede cambiar se incluyen las siguientes:

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. Estos incluyen lo siguiente:
Cantidad máxima de recursos de CPU de host que puede usar una máquina virtual.
Se esperaba el uso de 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 del host. Estos incluyen lo siguiente:
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 de BIOS para NumLock para una máquina virtual en un host de Hyper-V.
Configuración que identifica si una máquina virtual tiene una alta disponibilidad, es decir, una máquina virtual que se va a implementar en un nodo de un clúster de host de Hyper-V o un clúster de hosts de Citrix XenServer.
Establecer 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.
Se usa 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, Unidad de DVD virtual, adaptador de red virtual o adaptador SCSI virtual asociado a una máquina virtual específica, use el Set-SCVirtualFloppyDrive, Set-SCVirtualDVDDrive, Set-SCVirtualNetworkAdapter, o cmdlet 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 un 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 usado 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 ahora a los miembros del rol de usuario de autoservicio denominado SSUserRole3 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. En este ejemplo se muestra 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 para $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 un error de no terminación a un error de terminació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, se requiere deshabilitar la sincronización de tiempo para las máquinas virtuales que actúan como controladores de dominio. El comando usa la instrucción intercept para detectar excepciones de terminación. Si se produce un error en el comando set-SCVirtualMachine , se muestra la cadena de la captura instrucción. Continue se usa en la instrucción trap para continuar ejecutándose en lugar de salir. El cmdlet Out-Null redirige la salida a $Null en lugar de enviarlo 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 un error de no terminación a un error de terminació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 garantiza que el comando almacene los resultados en una matriz en caso de que el comando devuelva un solo objeto o un valor NULL.

El cuarto comando establece el orden de arranque del BIOS de 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 Hyper-V y Citrix XenServer. No se usa para máquinas virtuales en hosts de VMware ESX. Los hosts xenServer no admiten discos de disquete y, por lo tanto, omite Floppy si aparece 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 forE achforEach estándar de Windows PowerShell, escriba .

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 estado de 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 la 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.

Tipo:	UInt16
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AutomaticCriticalErrorActionTimeout

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

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-AvailabilitySetNames

Especifica una lista de nombres de conjuntos de disponibilidad.

Tipo:	System.Collections.Generic.List`1[System.String]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-BlockDynamicOptimization

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

Tipo:	Boolean
Alias:	ExcludeFromPRO
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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

Tipo:	BootDevice[]
Valores aceptados:	Floppy, CD, IdeHardDrive, PxeBoot, Unknown
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CapabilityProfile

Especifica un objeto de perfil de funcionalidad.

Tipo:	CapabilityProfile
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CheckpointType

Especifica el tipo de punto de control. Los valores aceptables para este parámetro son:

Deshabilitado
Producción
ProductionOnly
Estándar

Tipo:	CheckpointType
Valores aceptados:	Disabled, Production, ProductionOnly, Standard
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClearDRProtection

Indica que este cmdlet restablece la opción de protección de recuperación de datos.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Cloud

Especifica un objeto de nube privada.

Tipo:	Cloud
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClusterNonPossibleOwner

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

Tipo:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ClusterPreferredOwner

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

Tipo:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Host]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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, en función del 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 ejecute Windows NT 4.0.
Citrix XenServer. Hasta ocho CPU por máquina virtual, en función del sistema operativo invitado.

Tipo:	Byte
Alias:	ProcessorCount
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int32
Alias:	ExpectedCPUUtilization
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 que tienen procesadores de diferentes fabricantes.

Tipo:	Boolean
Alias:	LimitCPUForMigration
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Boolean
Alias:	LimitCPUFunctionality
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Int32
Alias:	CPUMax
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CPUPerVirtualNumaNodeMaximum

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

Tipo:	Byte
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CPURelativeWeight

Especifica la cantidad de recursos de CPU en un host que esta máquina virtual puede usar 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. Alto. 2000.
VMware ESX. Por encima de normal. 1500.
VMware ESX. Normal (valor predeterminado). 1000.
VMware ESX. Por debajo de normal. 750.
VMware ESX. Bajo. 500.
VMware ESX. Personalizado de 1 a 1000000.
Citrix XenServer. Entre 1 y 65536, el valor típico es 256.

Tipo:	Int32
Alias:	RelativeWeight
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 CPU que está disponible para la máquina virtual nunca es menor que este porcentaje.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CPUType

Especifica el tipo de CPU para una máquina virtual. Para obtener todos los tipos de CPU disponibles para su uso en máquinas virtuales en un entorno VMM, consulte el cmdlet Get-SCCPUType.

Tipo:	ProcessorType
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False