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
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 |
|
| Archivo DLL |
|