Win32_Terminal clase

La Win32_Terminal clase WMI representa un terminal.

La siguiente sintaxis se simplifica desde el código MOF e incluye todas las propiedades definidas y heredadas, en orden alfabético. Para obtener información de referencia sobre los métodos, consulte la tabla de métodos más adelante en este tema.

Sintaxis

[dynamic, overwrite, provider("Win32_WIN32_TERMINAL_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_Terminal : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint32   fEnableTerminal;
  uint32   LoggedOnUsers;
  string   TerminalName;
};

Miembros

La clase Win32_Terminal tiene estos tipos de miembros:

• Métodos
• Propiedades

Métodos

La clase Win32_Terminal tiene estos métodos.

Método	Descripción
Crear	Crea un terminal con la configuración predeterminada que se puede personalizar mediante las propiedades y los métodos de las clases Win32_TerminalSetting .
Eliminar	Elimina el terminal especificado.
Habilitar	Deshabilita o habilita el terminal.
Cambiar nombre	Cambia el nombre del terminal.

Propiedades

La clase Win32_Terminal tiene estas propiedades.

Caption

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (64)

Descripción corta (cadena de una línea) del objeto .

Esta propiedad se hereda de CIM_ManagedSystemElement.

Descripción

Tipo de datos: cadena

Tipo de acceso: solo lectura

Descripción del objeto .

Esta propiedad se hereda de CIM_ManagedSystemElement.

fEnableTerminal

Tipo de datos: uint32

Tipo de acceso: solo lectura

Especifica si el terminal especificado está deshabilitado o habilitado.

FALSE (0)

El terminal está deshabilitado.

TRUE (1)

El terminal está habilitado.

InstallDate

Tipo de datos: datetime

Tipo de acceso: solo lectura

Calificadores: Mappingstrings ("MIF. DMTF| ComponentID|001.5")

Fecha en que se instaló el objeto. La falta de un valor no indica que el objeto no está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

LoggedOnUsers

Tipo de datos: uint32

Tipo de acceso: solo lectura

Número de sesiones de inicio de sesión para el terminal.

Nombre

Tipo de datos: cadena

Tipo de acceso: solo lectura

El nombre del objeto.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Estado

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: MaxLen (10)

Estado actual del objeto. Se pueden definir varios estados operativos y no operativos. Los estados operativos incluyen: "Ok", "Degradado" y "Error previo" (un elemento, como una unidad de disco duro habilitada para SMART, puede funcionar correctamente, pero predecir un error en un futuro próximo). Los estados no operativos incluyen: "Error", "Inicio", "Detención" y "Servicio". Este último, "Servicio", podría aplicarse durante la resilveración de reflejo de un disco, la recarga de una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "Correcto" ni en uno de los otros estados.

Esta propiedad se hereda de CIM_ManagedSystemElement.

("Ok")

("Error")

("Degradado")

("Desconocido")

("Error previo")

("Inicio")

("Detener")

("Servicio")

TerminalName

Tipo de datos: cadena

Tipo de acceso: solo lectura

Calificadores: key

Nombre único que identifica la instancia del terminal.

Comentarios

Win32_Terminal está asociado a Win32_TerminalSetting como la propiedad Element de la asociación Win32_TerminalTerminalSetting .

Las siguientes clases son subclases de la clase Win32_Terminal : Win32_TSGeneralSetting, Win32_TSLogonSetting, Win32_TSSessionSetting, Win32_TSEnvironmentSetting, Win32_TSRemoteControlSetting, Win32_TSClientSetting, Win32_TSNetworkAdapterSetting, Win32_TSNetworkAdapterListSetting, Win32_TSPermissionsSetting y Win32_TSAccount.

Tenga en cuenta que Winstations asociados a la sesión de consola no puede acceder a los métodos y propiedades de esta clase. Si se intenta hacerlo especificando "Console" como valor de la propiedad TerminalName , los métodos de este objeto devuelven WBEM_E_NOT_SUPPORTED. Este código de error también se devuelve si una estación de ventana intenta llamar a métodos de este objeto para agregar o modificar las propiedades de seguridad de las cuentas LocalSystem, LocalService o NetworkService.

Para conectarse al espacio de nombres \root\CIMV2\TerminalServices, el nivel de autenticación debe incluir la privacidad del paquete. Para las llamadas de C/C++, se trata de un nivel de autenticación de RPC_C_AUTHN_LEVEL_PKT_PRIVACY. En el caso de las llamadas de Visual Basic y scripting, se trata de un nivel de autenticación de WbemAuthenticationLevelPktPrivacy o "pktPrivacy", con un valor de 6. En el siguiente ejemplo de Visual Basic Scripting Edition (VBScript) se muestra cómo conectarse a un equipo remoto con privacidad de paquetes.

strComputer = "RemoteServer1" 
Set objServices = GetObject( _
    "winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")

Los archivos de Formato de objeto administrado (MOF) contienen las definiciones de clases de Instrumental de administración de Windows (WMI). Los archivos MOF no se instalan como parte del Kit de desarrollo de software (SDK) de Microsoft Windows. Se instalan en el servidor cuando se agrega el rol asociado mediante el Administrador del servidor. Para obtener más información sobre los archivos MOF, vea Managed Object Format (MOF).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMv2\TerminalServices
MOF	TSCfgWmi.mof
Archivo DLL	TSCfgWmi.dll

Consulte también

CIM_LogicalElement

Win32_TerminalServiceSetting

Win32_TerminalTerminalSetting