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
TSCfgWmi.mof
Archivo DLL
TSCfgWmi.dll

Consulte también

Win32_TerminalSetting

CIM_Setting