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

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

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

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

Detención (4)

Detenido (5)

Anulado (6)

Inactivo (7)

Completado (8)

Migración (9)

Migración (10)

Migración (11)

Instantáneas (12)

Apagado (13)

En prueba (14)

Transición (15)

En servicio (16)

DMTF Reserved (..)

Vendor Reserved (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 del 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)

Correcto (1)

Degradado (2)

Error (3)

DMTF Reserved (..)

Vendor Reserved (0x8000.. )

RequestedState

Tipo de datos: uint16

Tipo de acceso: solo lectura

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

Value 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, un sistema operativo inicia automáticamente el servicio 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 está ejecutando 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
WindowsVirtualization.V2.mof
Archivo DLL
Vmms.exe

Consulte también

CIM_VirtualSystemManagementService

CIM_VirtualSystemManagementService

Msvm_VirtualSystemManagementService (V1)

Clases de administración de sistemas virtuales