Msvm_VirtualSystemManagementService clase
Representa el servicio de virtualización presente en un único sistema host. Msvm_VirtualSystemManagementService se usa para controlar la definición, modificación y eliminación de máquinas virtuales. También tiene métodos para realizar operaciones en máquinas virtuales, como la clonación, la creación de instantáneas y la importación o exportación de máquinas virtuales. Para recuperar información por máquina virtual, use Msvm_ComputerSystem.
La siguiente sintaxis es código de Formato de objeto administrado (MOF) simplificado e incluye todas las propiedades heredadas.
Sintaxis
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualSystemManagementService : CIM_VirtualSystemManagementService
{
string InstanceID;
string Caption = "Virtual System Management Service";
string Description = "Service for creating, manipulating, and managing virtual machines";
string ElementName = "Hyper-V Virtual System Management Service";
datetime InstallDate;
string Name = "vmms";
uint16 OperationalStatus[] = { 2 };
string StatusDescriptions[] = { "The service is running normally" };
string Status;
uint16 HealthState = 5;
uint16 CommunicationStatus;
uint16 DetailedStatus;
uint16 OperatingStatus;
uint16 PrimaryStatus;
uint16 EnabledState = 2;
string OtherEnabledState;
uint16 RequestedState = 12;
uint16 EnabledDefault = 2;
datetime TimeOfLastStateChange;
uint16 AvailableRequestedStates[];
uint16 TransitioningToState;
string SystemCreationClassName = "Msvm_ComputerSystem";
string SystemName;
string CreationClassName = "Msvm_VirtualSystemManagementService";
string PrimaryOwnerName;
string PrimaryOwnerContact;
string StartMode;
boolean Started = True;
};
Miembros
La clase Msvm_VirtualSystemManagementService tiene estos tipos de miembros:
Métodos
La clase Msvm_VirtualSystemManagementService tiene estos métodos.
| Método | Descripción |
|---|---|
| AddBootSourceSettings | Agrega orígenes de arranque a una configuración del sistema virtual cuando se aplica a una configuración del sistema virtual de "estado". |
| AddFeatureSettings | Agrega la configuración de características Ethernet a la configuración de una conexión Ethernet de máquina virtual. |
| AddFibreChannelChap | Agrega parámetros DH-CHAP a un puerto de canal de fibra sintético en una máquina virtual. |
| AddGuestServiceSettings | Agrega la configuración del servicio invitado a una configuración del sistema virtual. Cuando se aplica a partes de una configuración del sistema virtual "actual", se pueden modificar los servicios invitados de efecto secundario del sistema virtual activo. |
| AddKvpItems | Agrega pares clave-valor a una máquina virtual. |
| AddResourceSettings | Agrega recursos a una configuración de máquina virtual. |
| AddSystemComponentSettings | Agrega valores genéricos a una configuración del sistema virtual. |
| DefinePlannedSystem | Define un sistema virtual planeado. La entrada que no está completamente especificada puede rellenarse con valores predeterminados. |
| DefineSystem | Crea una nueva definición de máquina virtual. |
| DestroySystem | Elimina una definición de máquina virtual existente. |
| DiagnoseNetworkConnection | Diagnostica la conectividad de red de una máquina virtual en un entorno de virtualización de red de Windows. |
| ExportSystemDefinition | Exporta una máquina virtual o una instantánea de una máquina virtual a un archivo. |
| FormatError | Devuelve una cadena de mensaje de error con formato para la matriz especificada de instancias de Msvm_Error incrustadas. |
| GenerateWwpn | Genera un conjunto de nombres de puertos de todo el mundo (WWPN). |
| GetCurrentWwpnFromGenerator | Proporciona la capacidad de obtener una vista previa del nombre de puerto mundial actual (WWPN) sin que se reserve el WWPN. |
| GetDefinitionFileSummaryInformation | Devuelve información de resumen de máquina virtual para los archivos de definición de máquina virtual especificados. |
| GetSizeOfSystemFiles | Recupera el tamaño total de los archivos del sistema de la máquina virtual. |
| GetSummaryInformation | Devuelve información de resumen de máquina virtual. |
| GetVirtualSystemThumbnailImage | Recupera una imagen en miniatura de una máquina virtual existente. |
| ImportSnapshotDefinitions | Busca en la carpeta especificada los archivos de definición de instantánea asociados al sistema de equipo planeado especificado y crea una nueva instantánea en el sistema de equipos planeados para cada archivo de definición asociado de esta ubicación. |
| ImportSystemDefinition | Crea un nuevo sistema de equipos planeado basado en la definición de máquina virtual especificada. |
| ModifyDiskMergeSettings | Modifica los datos de configuración de combinación de discos. |
| ModifyFeatureSettings | Modifica la configuración de características actual de una conexión Ethernet de máquina virtual. |
| ModifyGuestServiceSettings | Modifica la configuración del servicio invitado. Cuando se aplica a partes de una configuración del sistema virtual "actual", se pueden modificar los servicios invitados de efecto secundario del sistema virtual activo. |
| ModifyKvpItems | Modifica los pares clave-valor existentes en una máquina virtual. |
| ModifyResourceSettings | Modifica la configuración de recursos virtuales. |
| ModifyServiceSettings | Modifica los datos de configuración del servicio. |
| ModifySystemComponentSettings | Modifica la configuración genérica del componente del sistema. |
| ModifySystemSettings | Modifica la configuración de la máquina virtual. |
| RealizePlannedSystem | Valida la configuración de una máquina virtual planeada y la convierte en una máquina virtual realizada. |
| RemoveBootSourceSettings | Quita la configuración de recursos virtuales de una configuración del sistema virtual. Cuando se aplica a partes de una configuración del sistema virtual "actual", se pueden quitar los recursos de efecto secundario del sistema virtual activo. |
| RemoveFeatureSettings | Quita la configuración de características de una conexión Ethernet de máquina virtual. |
| RemoveFibreChannelChap | Quita los parámetros DH-CHAP de un puerto de canal de fibra sintético en una máquina virtual. |
| RemoveGuestServiceSettings | Quita la configuración del servicio invitado de una configuración del sistema virtual. Cuando se aplica a partes de una configuración del sistema virtual "actual", se pueden modificar los servicios invitados de efecto secundario del sistema virtual activo. |
| RemoveKvpItems | Quita los pares clave-valor existentes de una máquina virtual. |
| RemoveResourceSettings | Quita la configuración de recursos virtuales de una configuración de máquina virtual. |
| RemoveSystemComponentSettings | Quita la configuración de componentes genéricos de una configuración del sistema virtual. |
| RequestStateChange | No se admite este método. |
| SetGuestNetworkAdapterConfiguration | Configura los adaptadores de red dentro del sistema operativo invitado. |
| SetInitialMachineConfigurationData | Establece los datos de configuración iniciales de la máquina virtual. |
| StartService | No se admite este método. |
| StopService | No se admite este método. |
| TestNetworkConnection | Prueba la conectividad de red de una máquina virtual en un entorno de virtualización de red de Windows. |
| UpgradeSystemVersion | Actualiza el sistema virtual. Cuando se aplica a la configuración del sistema de una configuración del sistema virtual "actual" |
| ValidatePlannedSystem | Valida el sistema planeado especificado. |
Propiedades
La clase Msvm_VirtualSystemManagementService tiene estas propiedades.
-
AvailableRequestedStates
-
-
Tipo de datos: matriz uint16
-
Tipo de acceso: solo lectura
Indica los valores posibles para el parámetro RequestedState del método RequestStateChange . Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en Null.
-
-
Caption
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Descripción breve del objeto. Esta propiedad se hereda de CIM_ManagedElement y siempre se establece en "Servicio de administración de sistemas virtuales de Hyper-V".
-
-
CommunicationStatus
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Indica la capacidad de la instrumentación para comunicarse con el elemento administrado subyacente. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.
-
Desconocido (0)
-
No disponible (1)
-
Comunicación correcta (2)
-
Comunicación perdida (3)
-
Sin contacto (4)
-
DMTF Reserved (..)
-
Vendor Reserved (0x8000.. )
-
-
CreationClassName
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Key, MaxLen ( 256 )
Nombre de la clase o subclase usada en la creación de una instancia. Esta propiedad se hereda de CIM_Service y siempre se establece en "Msvm_VirtualSystemManagementService".
-
-
Descripción
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Descripción del objeto. Esta propiedad se hereda de CIM_ManagedElement y siempre se establece en "Servicio para crear, manipular y administrar máquinas virtuales".
-
-
DetailedStatus
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Complementa la propiedad PrimaryStatus con detalles de estado adicionales. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.
-
No disponible (0)
-
Sin información adicional (1)
-
Estresado (2)
-
Error predictivo (3)
-
Error no recuperable (4)
-
Entidad auxiliar en error (5)
-
DMTF Reserved (..)
-
Vendor Reserved (0x8000.. )
-
-
ElementName
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Nombre para mostrar del objeto. Esta propiedad se hereda de CIM_ManagedElement y siempre se establece en "Servicio de administración de sistemas virtuales de Hyper-V".
-
-
EnabledDefault
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Configuración de inicio o predeterminada de un administrador para el estado habilitado de un elemento. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en 2 (Habilitado).
Valor Significado - 2
habilitado -
-
EnabledState
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Estados habilitados y deshabilitados de un elemento. Esta propiedad también puede indicar las transiciones entre estos estados solicitados. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en 2 (Habilitado).
Valor Significado - 2
habilitado -
-
HealthState
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Estado actual del elemento. Este atributo expresa el estado de este elemento, pero no necesariamente el de sus subcomponentes. Los valores posibles son de 0 a 30, donde 5 significa que el elemento es completamente correcto y 30 significa que el elemento no funciona completamente. Esta propiedad se hereda de CIM_ManagedSystemElement y siempre se establece en 5 (Correcto).
Valor Significado - 5
El estado de mantenimiento es normal. -
-
InstallDate
-
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
Fecha y hora en que se creó la configuración de la máquina virtual. Esta propiedad se hereda de CIM_ManagedSystemElement.
-
-
InstanceID
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Clave
Identifica de forma única una instancia de esta clase. Esta propiedad se hereda de CIM_ManagedElement.
-
-
Nombre
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Key, MaxLen ( 256 )
Etiqueta por la que se conoce el objeto. Esta propiedad se hereda de CIM_ManagedSystemElement y siempre se establece en "vmms".
-
-
OperatingStatus
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Proporciona información de estado actual para la condición operativa del elemento y se puede usar para proporcionar más detalles con respecto al valor de la propiedad EnabledState . Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.
-
Desconocido (0)
-
No disponible (1)
-
Mantenimiento (2)
-
A partir de (3)
-
Detener (4)
-
Detenido (5)
-
Anulado (6)
-
Inactivo (7)
-
Completado (8)
-
Migración (9)
-
Emigración (10)
-
Migración (11)
-
Instantáneas (12)
-
Apagar (13)
-
En prueba (14)
-
Transición (15)
-
En servicio (16)
-
DMTF Reserved (..)
-
Proveedor reservado (0x8000.. )
-
-
OperationalStatus
-
-
Tipo de datos: matriz uint16
-
Tipo de acceso: solo lectura
Estados actuales del objeto . Esta propiedad se hereda de CIM_ManagedSystemElement y cada elemento de matriz siempre se establece en 2 (OK).
-
-
OtherEnabledState
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Cadena que describe el estado habilitado o deshabilitado del elemento cuando la propiedad EnabledState está establecida en 1 ("Other"). Esta propiedad debe establecerse en Null cuando EnabledState es cualquier valor distinto de 1. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en Null.
-
-
PrimaryOwnerContact
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen ( 256 )
Cualquier información sobre cómo se puede acceder al propietario principal del servicio (por ejemplo, número de teléfono, dirección de correo electrónico, etc.). Esta propiedad se hereda de CIM_Service y siempre se establece en Null.
-
-
PrimaryOwnerName
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen ( 64 )
Nombre del propietario principal del servicio, si se define uno. El propietario principal es el contacto de soporte técnico inicial para el servicio. Esta propiedad se hereda de CIM_Service y siempre se establece en Null.
-
-
PrimaryStatus
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Proporciona información de estado de alto nivel. Esta propiedad debe usarse junto con la propiedad DetailedStatus para proporcionar un estado de mantenimiento alto y detallado del elemento y sus subcomponentes. Un valor Null indica que esta propiedad no está implementada. Esta propiedad se hereda de CIM_ManagedSystemElement.
-
Desconocido (0)
-
Ok (1)
-
Degradado (2)
-
Error (3)
-
DMTF Reserved (..)
-
Proveedor reservado (0x8000.. )
-
-
RequestedState
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Último estado solicitado o deseado para el elemento. El estado real del elemento se representa mediante EnabledState. Esta propiedad se proporciona para comparar los últimos estados solicitados y actuales de un elemento. Es posible que una instancia determinada de la clase CIM_EnabledLogicalElement no admita la propiedad RequestedState . Si esto ocurre, se usa el valor 12 ("No aplicable"). Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en 12 (no aplicable).
Valor Significado - 12
No es aplicable. -
-
Introducción
-
-
Tipo de datos: booleano
-
Tipo de acceso: solo lectura
Indica si el servicio se está ejecutando actualmente. Esta propiedad se hereda de CIM_Service y siempre se establece en True.
-
-
StartMode
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen ( 10 )
Valor de cadena que indica si un sistema inicia automáticamente el servicio, un sistema operativo o solo se inicia a petición. Esta propiedad se hereda de CIM_Service y siempre se establece en Null.
-
-
Estado
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Esta propiedad se hereda de CIM_ManagedSystemElement, pero no se usa.
-
-
StatusDescriptions
-
-
Tipo de datos: matriz de cadenas
-
Tipo de acceso: solo lectura
Cadenas que describen los distintos valores de matriz OperationalStatus . Esta propiedad se hereda de CIM_ManagedSystemElement, y cada elemento de matriz siempre se establece en "El servicio se ejecuta normalmente".
-
-
SystemCreationClassName
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Key, MaxLen ( 256 )
Nombre de la clase de creación del sistema de ámbito. Esta propiedad se hereda de CIM_Service y siempre se establece en "Msvm_ComputerSystem".
-
-
SystemName
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: Key, MaxLen ( 256 )
Nombre NetBIOS del sistema de equipo host. Esta propiedad se hereda de CIM_Service.
-
-
TimeOfLastStateChange
-
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
Fecha u hora en que el estado habilitado del elemento cambió por última vez. Esta propiedad se hereda de CIM_EnabledLogicalElement.
-
-
TransitioningToState
-
-
Tipo de datos: uint16
-
Tipo de acceso: solo lectura
Indica el estado de destino al que se está realizando la transición de la instancia. Esta propiedad se hereda de CIM_EnabledLogicalElement y siempre se establece en Null.
-
Observaciones
El filtrado UAC puede restringir el acceso a la clase Msvm_VirtualSystemManagementService . Para obtener más información, consulte Control de cuentas de usuario y WMI.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2012 [solo aplicaciones de escritorio] |
| Espacio de nombres |
Root\Virtualization\V2 |
| MOF |
|
| Archivo DLL |
|