Compartir a través de

Msvm_TerminalService clase

  • Artículo

Administra todas las conexiones de terminal remoto a un host determinado. El servicio usa un puerto configurable para iniciar todas las conexiones de terminal.

La sintaxis siguiente es código de Formato de objeto administrado (MOF) simplificado e incluye todas las propiedades heredadas.

Sintaxis

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_TerminalService : CIM_Service
{
  string   InstanceID;
  string   Caption = "Hyper-V Terminal Service";
  string   Description = "Microsoft Virtual Terminal Service";
  string   ElementName = "Hyper-V Terminal Service";
  datetime InstallDate;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "The virtual terminal connection management service is fully operational" };
  string   Status = "OK";
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   Name = "termsvc";
  string   CreationClassName = "Msvm_TerminalService";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   StartMode;
  boolean  Started;
};

Miembros

La clase Msvm_TerminalService tiene estos tipos de miembros:

Métodos

La clase Msvm_TerminalService tiene estos métodos.

Método Descripción
GetInteractiveSessionACL Recupera la DACL actual que controla el acceso a la sesión interactiva de una máquina virtual.
GrantInteractiveSessionAccess Concede acceso a la sesión interactiva de la máquina virtual a la lista especificada de administradores.
ModifyServiceSettings Modifica los datos de configuración del servicio.
RequestStateChange Solicita un cambio de estado.
RevokeInteractiveSessionAccess Revoca el acceso a la sesión interactiva de la máquina virtual de la lista especificada de administradores.
StartService inicia el servicio.
StopService detiene el servicio.

Propiedades

La clase Msvm_TerminalService 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.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

Descripción breve del objeto. Esta propiedad se hereda de CIM_ManagedElement.

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

Proveedor reservado (0x8000.. )

CreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre de la clase o subclase usada en la creación de una instancia. Esta propiedad se hereda de CIM_Service.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Descripción del objeto. Esta propiedad se hereda de CIM_ManagedElement.

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

Proveedor reservado (0x8000.. )

ElementName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre para mostrar del objeto. Esta propiedad se hereda de CIM_ManagedElement.

EnabledDefault

Tipo de datos: uint16

Tipo de acceso: solo lectura

Configuración predeterminada o de inicio de un administrador para el estado habilitado de un elemento. Esta propiedad se hereda de CIM_EnabledLogicalElement.

EnabledState

Tipo de datos: cadena

Tipo de acceso: solo lectura

Estados habilitados y deshabilitados de un elemento. También puede indicar las transiciones entre estos estados solicitados. Esta propiedad se hereda de CIM_EnabledLogicalElement.

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.

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 y siempre se establece en Null.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

Etiqueta por la que se conoce el objeto. Esta propiedad se hereda de CIM_Service.

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.

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 (Otro). Esta propiedad debe establecerse en Null cuando EnabledState es cualquier valor distinto de 1. Esta propiedad se hereda de CIM_EnabledLogicalElement.

PrimaryOwnerContact

Tipo de datos: cadena

Tipo de acceso: solo lectura

Valor que proporciona 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.

PrimaryOwnerName

Tipo de datos: cadena

Tipo de acceso: solo lectura

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.

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 habilitados o deshabilitados actuales. Es posible que una instancia determinada de CIM_EnabledLogicalElement no admita el método RequestStateChange . Si esto ocurre, se usa el valor 12 (no aplicable). Esta propiedad se hereda de CIM_EnabledLogicalElement.

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.

StartMode

Tipo de datos: cadena

Tipo de acceso: solo lectura

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.

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

Estado del elemento. Esta propiedad se hereda de CIM_ManagedSystemElement.

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.

SystemCreationClassName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre de la clase de creación del sistema de ámbito. Esta propiedad se hereda de CIM_Service.

SystemName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Nombre del sistema de equipo de hospedaje. 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.

Comentarios

El filtrado UAC puede restringir el acceso a la clase Msvm_TerminalService . 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_Service