Win32_TSSessionSetting clase
La clase WMI de Win32_TSSessionSetting define los valores de configuración de la clase Win32_Terminal , como los límites de tiempo y las acciones de desconexión y reconexión.
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, provider("Win32_WIN32_TSSESSIONSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSSessionSetting : Win32_TerminalSetting
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
string TerminalName;
uint32 ActiveSessionLimit;
uint32 BrokenConnectionAction;
uint32 BrokenConnectionPolicy;
uint32 DisconnectedSessionLimit;
uint32 IdleSessionLimit;
uint32 PolicySourceActiveSessionLimit;
uint32 PolicySourceBrokenConnectionAction;
uint32 PolicySourceDisconnectedSessionLimit;
uint32 PolicySourceIdleSessionLimit;
uint32 PolicySourceReconnectionPolicy;
uint32 ReconnectionPolicy;
uint32 TimeLimitPolicy;
uint32 EnableTimeoutWarning;
};
Miembros
La clase Win32_TSSessionSetting tiene estos tipos de miembros:
Métodos
La clase Win32_TSSessionSetting tiene estos métodos.
Método | Descripción |
---|---|
BrokenConnection | Establece las propiedades de conexión interrumpidas incluidas en esta clase. |
TimeLimit | Establece las propiedades de límite de tiempo incluidas en esta clase. |
Propiedades
La clase Win32_TSSessionSetting tiene estas propiedades.
-
ActiveSessionLimit
-
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Cantidad máxima de tiempo, en milisegundos, asignada a una sesión activa. Un valor de 0 especifica una cantidad infinita de tiempo.
-
-
BrokenConnectionAction
-
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
La acción que el servidor realiza en la sesión cuando se ha interrumpido una conexión debido a la pérdida de red o a límites de tiempo superados.
-
-
Desconectar (0)
-
El usuario está desconectado de la sesión.
-
Finalizar (1)
-
La sesión se elimina permanentemente del servidor.
BrokenConnectionPolicy
-
Tipo de datos: uint32
-
Tipo de acceso: lectura/escritura
La directiva que usa el servidor para determinar cuándo interrumpir una conexión debido a la pérdida de red o superar los límites de tiempo.
Invalidación del servidor (1)
El servidor invalida la configuración de la directiva de desconexión del usuario.
Por usuario (0)
La configuración de la directiva de desconexión del usuario está en vigor.
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.
DisconnectedSessionLimit
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Intervalo de tiempo, en milisegundos, después del cual finaliza una sesión desconectada. Un valor de 0 especifica una cantidad infinita de tiempo.
EnableTimeoutWarning
-
Tipo de datos: uint32
-
Tipo de acceso: lectura/escritura
Habilita la advertencia de tiempo de espera.
Windows 7, Windows Server 2008 R2, Windows Vista y Windows Server 2008: Esta propiedad no está disponible.
IdleSessionLimit
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Intervalo de tiempo, en milisegundos, después del cual finaliza una sesión inactiva. Un valor de 0 especifica una cantidad infinita de tiempo.
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.
Nombre
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
El nombre del objeto.
Esta propiedad se hereda de CIM_ManagedSystemElement.
PolicySourceActiveSessionLimit
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Indica si la propiedad ActiveSessionLimit está configurada por el servidor, la directiva de grupo o de forma predeterminada.
0
Servidor
1
Directiva de grupo
2
Default
PolicySourceBrokenConnectionAction
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Indica si la propiedad BrokenConnectionAction está configurada por el servidor, la directiva de grupo o de forma predeterminada.
0
Servidor
1
Directiva de grupo
2
Default
PolicySourceDisconnectedSessionLimit
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Indica si la propiedad DisconnectedSessionLimit está configurada por el servidor, la directiva de grupo o de forma predeterminada.
0
Servidor
1
Directiva de grupo
2
Default
PolicySourceIdleSessionLimit
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Indica si la propiedad IdleSessionLimit está configurada por el servidor, la directiva de grupo o de forma predeterminada.
0
Servidor
1
Directiva de grupo
2
Default
PolicySourceReconnectionPolicy
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Indica si la propiedad ReconnectPolicy está configurada por el servidor, la directiva de grupo o de forma predeterminada.
0
Servidor
1
Directiva de grupo
2
Default
ReconnectionPolicy
-
Tipo de datos: uint32
-
Tipo de acceso: lectura/escritura
Especifica si un usuario debe usar el cliente anterior para volver a conectarse a una sesión desconectada.
Cualquier cliente (0)
Cualquier cliente se usará para volver a conectarse.
Cliente anterior (1)
El cliente anterior usado en una conexión se usará para volver a conectarse.
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 "Pred Fail" (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", "Starting", "Stopping" y "Service". Este último, "Servicio", podría aplicarse durante la reestablecimiento 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 "OK" ni en uno de los otros estados.
Esta propiedad se hereda de CIM_ManagedSystemElement.
("Ok")
("Error")
("Degradado")
("Desconocido")
("Error previo")
("Starting")
("Detener")
("Servicio")
TerminalName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Nombre del terminal.
Esta propiedad se hereda de Win32_TerminalSetting.
TimeLimitPolicy
-
Tipo de datos: uint32
-
Tipo de acceso: lectura/escritura
La directiva que usa el servidor para determinar los límites de tiempo de las sesiones de usuario.
Por usuario (0)
La configuración de la directiva de límites de tiempo del usuario está en vigor.
Invalidación del servidor (1)
El servidor invalida la configuración de directiva de límites de tiempo del usuario.
Comentarios
Tenga en cuenta que Winstations asociada a la sesión de consola no puede tener acceso 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 devolverán WBEM_E_NOT_SUPPORTED. Este código de error también se devolverá si una estación de ventana intenta llamar a métodos de este objeto con el fin de 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++, este sería un nivel de autenticación de RPC_C_AUTHN_LEVEL_PKT_PRIVACY. En el caso de las llamadas de Visual Basic y scripting, este sería 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 managed Object Format (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) (Formato de objeto administrado [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 |
|