Win32_TSSessionSetting 类

项目
06/12/2023

Win32_TSSessionSetting WMI 类定义Win32_Terminal类的配置设置，例如时间限制、断开连接和重新连接操作。

以下语法从 MOF 代码中简化，包括所有已定义和继承的属性（按字母顺序排列）。有关方法的参考信息，请参阅本主题后面的方法表。

语法

[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;
};

成员

Win32_TSSessionSetting 类具有以下类型的成员：

方法
属性

方法

Win32_TSSessionSetting 类具有这些方法。

方法	说明
BrokenConnection	设置此类中包含的断开连接属性。
TimeLimit	设置此类中包含的时间限制属性。

属性

Win32_TSSessionSetting 类具有这些属性。

ActiveSessionLimit

数据类型： uint32
访问类型：只读

分配给活动会话的最长时间（以毫秒为单位）。值为 0 指定无限时间。

BrokenConnectionAction

数据类型： uint32
访问类型：只读

当连接因网络丢失或超出时间限制而中断时，服务器对会话执行的操作。

断开连接 (0)

用户与会话断开连接。

终止 (1)

会话将从服务器中永久删除。

BrokenConnectionPolicy

数据类型： uint32
访问类型：读/写

服务器用于确定何时因网络丢失或超出时间限制而中断连接的策略。

Server-Override (1)

用户的断开连接策略设置由服务器替代。

每个用户 (0)

用户的断开连接策略设置已生效。

Caption

数据类型： string
访问类型：只读
限定符： MaxLen (64)

对象的单行字符串) (简短说明。

此属性继承自 CIM_ManagedSystemElement。

描述

数据类型： string
访问类型：只读

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

DisconnectedSessionLimit

数据类型： uint32
访问类型：只读

断开连接的会话终止的时间间隔（以毫秒为单位）。值为 0 指定无限时间。

EnableTimeoutWarning

数据类型： uint32
访问类型：读/写

启用超时警告。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008： 此属性不可用。

IdleSessionLimit

数据类型： uint32
访问类型：只读

空闲会话终止的时间间隔（以毫秒为单位）。值为 0 指定无限时间。

InstallDate

数据类型： datetime
访问类型：只读
限定符： 映射字符串 (“MIF”。DMTF |ComponentID|001.5“)

对象的安装日期。缺少值并不表示未安装对象。

此属性继承自 CIM_ManagedSystemElement。

名称

数据类型： string
访问类型：只读

对象的名称。

此属性继承自 CIM_ManagedSystemElement。

PolicySourceActiveSessionLimit

数据类型： uint32
访问类型：只读

指示 ActiveSessionLimit 属性是由服务器、组策略还是默认配置。

服务器

组策略

默认

PolicySourceBrokenConnectionAction

数据类型： uint32
访问类型：只读

指示 BrokenConnectionAction 属性是由服务器、组策略还是默认配置。

服务器

组策略

默认

PolicySourceDisconnectedSessionLimit

数据类型： uint32
访问类型：只读

指示是按服务器、组策略还是默认配置 DisconnectedSessionLimit 属性。

服务器

组策略

默认

PolicySourceIdleSessionLimit

数据类型： uint32
访问类型：只读

指示 IdleSessionLimit 属性是由服务器、组策略还是默认配置。

服务器

组策略

默认

PolicySourceReconnectionPolicy

数据类型： uint32
访问类型：只读

指示是按服务器、组策略还是默认配置 ConnectionPolicy 属性。

服务器

组策略

默认

ReconnectionPolicy

数据类型： uint32
访问类型：读/写

指定用户是否必须使用以前的客户端重新连接到断开连接的会话。

任何客户端 (0)

任何客户端都将用于重新连接。

上一个客户端 (1)

连接中使用的上一个客户端将用于重新连接。

Status

数据类型： 字符串
访问类型：只读
限定符： MaxLen (10)

对象的当前状态。可以定义各种操作和非操作状态。操作状态包括：“正常”、“降级”和“预失败”， (元素（例如已启用 SMART 的硬盘驱动器）可能正常运行，但预测近期) 故障。非操作状态包括：“错误”、“正在启动”、“正在停止”和“服务”。后者“服务”可以在磁盘镜像重新同步、重新加载用户权限列表或其他管理工作期间应用。并非所有此类工作都是在线的，但托管元素既不是“正常”，也不是处于其他状态之一。

此属性继承自 CIM_ManagedSystemElement。

(“确定”)

(“错误”)

(“已降级”)

(“未知”)

(“Pred Fail”)

(“启动”)

(“停止”)

(“Service”)

TerminalName

数据类型： 字符串
访问类型：只读

终端的名称。

此属性继承自 Win32_TerminalSetting。

TimeLimitPolicy

数据类型： uint32
访问类型：读/写

服务器用于确定用户会话的时间限制的策略。

每个用户 (0)

用户的时间限制策略设置有效。

服务器替代 (1)

服务器将覆盖用户的时间限制策略设置。

备注

请注意，与控制台会话关联的 Winstation 无法访问此类的方法和属性。如果尝试通过将“Console”指定为 TerminalName 属性的值来执行此操作，则此对象的方法将返回 WBEM_E_NOT_SUPPORTED。如果窗口站尝试调用此对象的方法以添加或修改 LocalSystem、LocalService 或 NetworkService 帐户的安全属性，则也会返回此错误代码。

若要连接到“root\CIMV2\TerminalServices”命名空间，身份验证级别必须包含数据包隐私。对于 C/C++ 调用，此身份验证级别为 RPC_C_AUTHN_LEVEL_PKT_PRIVACY。对于 Visual Basic 和脚本调用，这将是 WbemAuthenticationLevelPktPrivacy 或“pktPrivacy”的身份验证级别，值为 6。以下 Visual Basic Scripting Edition (VBScript) 示例演示如何使用数据包隐私连接到远程计算机。

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

托管对象格式 (MOF) 文件包含 Windows Management Instrumentation (WMI) 类的定义。 MOF 文件未作为 Microsoft Windows 软件开发工具包 (SDK) 的一部分安装。使用服务器管理器添加关联角色时，这些角色将安装在服务器上。有关 MOF 文件的详细信息，请参阅托管对象格式 (MOF) 。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
命名空间	Root\CIMv2\TerminalServices
MOF	TSCfgWmi.mof
DLL	TSCfgWmi.dll

另请参阅

Win32_TerminalSetting
CIM_Setting

通过

Win32_TSSessionSetting 类

语法

成员

方法

属性

备注

要求

另请参阅

反馈

其他资源