通过

Win32_TerminalServiceSetting 类

  • 项目

Win32_TerminalServiceSetting WMI 类表示远程桌面会话主机 (RD 会话主机) 服务器的配置。 设置包括 RD 会话主机服务器模式、许可、活动桌面、权限、删除临时文件夹和会话的临时目录等功能。

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

语法

[dynamic, provider("Win32_WIN32_TERMINALSERVICESETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TerminalServiceSetting : CIM_Setting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   ServerName;
  uint32   TerminalServerMode;
  uint32   GetCapabilitiesID;
  uint32   LicensingType;
  uint32   PolicySourceLicensingType;
  uint32   PossibleLicensingTypes;
  string   LicensingName;
  string   LicensingDescription;
  uint32   ActiveDesktop;
  uint32   UserPermission;
  uint32   DeleteTempFolders;
  uint32   PolicySourceDeleteTempFolders;
  uint32   UseTempFolders;
  uint32   PolicySourceUseTempFolders;
  uint32   AllowTSConnections;
  uint32   PolicySourceAllowTSConnections;
  uint32   SingleSession;
  uint32   PolicySourceSingleSession;
  string   ProfilePath;
  uint32   PolicySourceProfilePath;
  string   HomeDirectory;
  uint32   PolicySourceHomeDirectory;
  uint32   TimeZoneRedirection;
  uint32   PolicySourceTimeZoneRedirection;
  string   Logons;
  string   DirectConnectLicenseServers;
  uint32   PolicySourceDirectConnectLicenseServers;
  uint32   PolicySourceConfiguredLicenseServers;
  uint32   DisableForcibleLogoff;
  uint32   PolicySourceDisableForcibleLogoff;
  uint32   FallbackPrintDriverType;
  uint32   PolicySourceFallbackPrintDriverType;
  uint32   SessionBrokerDrainMode;
  uint32   LimitedUserSessions;
  uint32   EnableDFSS;
  uint32   PolicySourceEnableDFSS;
  uint32   EnableRemoteDesktopMSI;
  uint32   PolicySourceEnableRemoteDesktopMSI;
  uint32   EnableAutomaticReconnection;
  uint32   PolicySourceEnableAutomaticReconnection;
  uint32   UseRDEasyPrintDriver;
  uint32   PolicySourceUseRDEasyPrintDriver;
  uint32   RedirectSmartCards;
  uint32   PolicySourceRedirectSmartCards;
  uint32   EnableDiskFSS;
  uint32   EnableNetworkFSS;
  uint32   NetworkFSSUserSessionWeight;
  uint32   NetworkFSSLocalSystemWeight;
  uint32   NetworkFSSCatchAllWeight;
};

成员

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

方法

Win32_TerminalServiceSetting 类具有这些方法。

方法 说明
AddDirectConnectLicenseServer 在企业中配置新的许可证服务器。
AddLSToSpecifiedLicenseServerList 将给定的许可证服务器添加到指定许可证服务器列表的末尾。
CanAccessLicenseServer 确定是否允许 RD 会话主机服务器请求远程桌面服务客户端访问许可证， (RDS CAL 从远程桌面许可证服务器) 。
ChangeMode 设置远程桌面许可证服务器的许可类型。
CreateWinstation 基于侦听器名称和 NIC 的唯一组合创建新的侦听器堆栈。
DeleteDirectConnectLicenseServer 从企业中删除指定的许可证服务器。
EmptySpecifiedLicenseServerList 从指定许可证服务器列表中删除所有许可证服务器。
FindLicenseServers 枚举所有远程桌面许可证服务器和发现方法。
GetDomain 检索 RD 会话主机服务器所属的域的名称。
GetGracePeriodDays 检索 RD 会话主机服务器的 RD 许可宽限期内剩余的天数。
GetRegisteredLicenseServerList 获取已注册的许可证服务器的列表。
GetSpecifiedLicenseServerList 检索指定许可证服务器的列表。
GetTSLanaIds 获取远程桌面服务网络适配器的 ID 和说明。
GetTStoLSConnectivityStatus 确定远程桌面服务与许可证服务器之间的连接状态。
GetWinstationDriverNames 检索 Winstation 驱动程序名称的列表。
PingLicenseServer Ping 许可证服务器以确定它是否是有效的许可证服务器。
RemoveLSFromSpecifiedLicenseServerList 从指定许可证服务器列表中删除给定的许可证服务器。
SetAllowTSConnections 设置 AllowTSConnections 属性。
SetDisableForcibleLogoff 设置 DisableForcibleLogoff 属性。
SetFallbackPrintDriverType 设置 FallbackPrintDriverType 属性。
SetHomeDirectory 设置 HomeDirectory 属性。
SetPolicyPropertyName 设置以下属性之一： DeleteTempFolders 或 UseTempFolders。
SetPrimaryLicenseServer 将给定的许可证服务器设置为指定许可证服务器列表中的第一个条目。
SetProfilePath 设置 ProfilePath 属性。
SetSingleSession 设置 SingleSession 属性。
SetSpecifiedLicenseServerList 汇报指定许可证服务器的列表，替换任何现有的指定许可证服务器。
SetTimeZoneRedirection 设置 TimeZoneRedirection 属性。
UpdateDirectConnectLicenseServer 汇报发现许可证服务器的列表。

属性

Win32_TerminalServiceSetting 类具有这些属性。

ActiveDesktop

数据类型： uint32

访问类型：读/写

指定是否允许在每个用户会话中使用 Active Desktop。

TRUE (0)

不允许在每个用户会话中使用活动桌面。

FALSE (1)

每个用户会话中都允许使用活动桌面。

AllowTSConnections

数据类型： uint32

访问类型：只读

指定是否允许新的远程桌面服务连接。

FALSE (0)

不允许使用新连接。

TRUE (1)

允许新连接。

Caption

数据类型： 字符串

访问类型：只读

限定符： MaxLen (64)

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

此属性继承自 CIM_ManagedSystemElement。

DeleteTempFolders

数据类型： uint32

访问类型：只读

指定是否在退出时删除临时目录。

FALSE (0)

禁用删除临时目录。

TRUE (1)

启用临时目录删除。

描述

数据类型： string

访问类型：只读

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

DirectConnectLicenseServers

数据类型： string

访问类型：只读

限定符： 已弃用

此属性不可用。

Windows Server 2008： 枚举许可证服务器的列表。

DisableForcibleLogoff

数据类型： uint32

访问类型：只读

确定是否可以强行注销登录到主机的管理员。

0

管理员可以强行注销。

1

无法强行注销管理员。

EnableAutomaticReconnection

数据类型： uint32

访问类型：读/写

指定如果网络链接暂时丢失，是否允许远程桌面连接客户端自动重新连接到 RD 会话主机服务器上的会话。

0 (0x0)

已禁用自动重新连接。

1 (0x1)

已启用自动重新连接。

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

EnableDFSS

数据类型： uint32

访问类型：读/写

指示是启用还是禁用动态公平共享计划 (DFSS) 。 这可以是以下值之一。

Windows Server 2008： 此属性在 Windows Server 2008 R2 之前不可用。

0

DFSS 已禁用。

1

已启用 DFSS。

EnableDiskFSS

数据类型： uint32

访问类型：读/写

指定是否启用磁盘公平共享计划。

0 (0x0)

已禁用磁盘公平共享计划。

1 (0x1)

已启用磁盘公平共享计划。

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

EnableNetworkFSS

数据类型： uint32

访问类型：读/写

指定是否启用网络公平共享计划。

0 (0x0)

网络公平共享计划已禁用。

1 (0x1)

已启用网络公平共享计划。

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

EnableRemoteDesktopMSI

数据类型： uint32

访问类型：读/写

指示是启用还是禁用远程桌面 MSI。

0 (0x0)

已禁用

1 (0x1)

Enabled

Windows Server 2008： 此属性在 Windows Server 2008 R2 之前不可用。

FallbackPrintDriverType

数据类型： uint32

访问类型：只读

指定要回退到的打印机驱动程序。

无回退 dirvers=0 (0)

无回退驱动程序。

最佳猜测=1 (1)

最好的猜测。

最佳猜测，如果未找到匹配项，则回退到 PCL=2 (2)

最好的猜测。 如果未找到匹配项， (PCL) 回退到Hewlett-Packard打印机控制语言。

最佳猜测，如果未找到匹配项，则回退到 PS=3 (3)

最好的猜测。 如果未找到匹配项，则回退到 Postscript (PS) 。

最佳猜测，如果未找到匹配项，则显示 PCL 和 PS 驱动程序=4 (4)

最好的猜测。 如果未找到匹配项，请同时显示 PS 和 PCL 驱动程序。

GetCapabilitiesID

数据类型： uint32

访问类型：只读

提供程序的功能 ID。

HomeDirectory

数据类型： string

访问类型：只读

计算机的根目录。

InstallDate

数据类型： datetime

访问类型：只读

限定符： 映射字符串 (“MIF”。DMTF |ComponentID|001.5“)

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

此属性继承自 CIM_ManagedSystemElement。

LicensingDescription

数据类型： string

访问类型：只读

许可模式的简要说明。

LicensingName

数据类型： string

访问类型：只读

许可模式的名称。

LicensingType

数据类型： uint32

访问类型：只读

指定服务器模式的许可类型。

个人终端服务器 (0)

个人 RD 会话主机服务器。

Remote Desktop for Administration (1)

远程桌面管理。

每个设备 (2)

每个设备。 对应用程序服务器有效。

每用户 (3)

按用户。 对应用程序服务器有效。

未配置 (4)

未配置。

LimitedUserSessions

数据类型： uint32

访问类型：读/写

指示是否启用了限制 RD 会话主机服务器上允许的活动和非活动会话数的功能。 例如，你可能希望设置 LimitedUserSessions ，以确保 RD 会话主机服务器上安装的特定应用程序的许可证符合性。 或者，你可能想要限制负载均衡场中 RD 会话主机服务器上的最大会话数，以便在场中的另一台服务器发生故障时服务器不会重载。

注意

用于出于管理目的连接到服务器的会话不受 LimitedUserSessions 的影响。

在 RD 会话主机服务器场中，如果用户超出会话限制，该会话将通过 RD 连接代理负载均衡定向到另一台服务器。 如果服务器是独立服务器，则用户将无法连接。

由于用于管理目的连接到服务器的会话，以及登录周期期间强制实施会话数的时间安排，因此建议将 LimitedUserSessions 设置为一个值，该值略低于服务器上会话数的物理限制。

仅当安装了 RD 会话主机角色服务时， LimitedUserSessions 属性才有效。

0

此功能已禁用。

1 或更大

值 1 或更大表示 RD 会话主机服务器上允许的活动和非活动) (的最大会话数。

登录

数据类型： string

访问类型：读/写

指定是否允许新会话。 此设置不会影响现有设置。

0

允许新会话。

1

不允许新会话。

名称

数据类型： string

访问类型：只读

对象的名称。

此属性继承自 CIM_ManagedSystemElement。

NetworkFSSCatchAllWeight

数据类型： uint32

访问类型：读/写

指定捕获全部网络流量的默认网络公平份额权重。 有效值为 1 到 9。

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

NetworkFSSLocalSystemWeight

数据类型： uint32

访问类型：读/写

指定本地系统进程的默认网络公平份额权重。 有效值为 1 到 9。

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

NetworkFSSUserSessionWeight

数据类型： uint32

访问类型：读/写

指定用户会话的默认网络公平份额权重。 有效值为 1 到 9。

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

PolicySourceAllowTSConnections

数据类型： uint32

访问类型：只读

指示 AllowTSConnections 属性是由服务器还是组策略配置。

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceConfiguredLicenseServers

数据类型： uint32

访问类型：只读

指示 由 GetSpecifiedLicenseServerList 方法返回的许可证服务器是由服务器还是由组策略配置。

Windows Server 2008： 此属性不可用。

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceDeleteTempFolders

数据类型： uint32

访问类型：只读

指示 DeleteTempFolders 属性是由服务器还是由组策略配置。

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceDirectConnectLicenseServers

数据类型： uint32

访问类型：只读

限定符： 已弃用

此属性不可用。

Windows Server 2008： 指示 DirectConnectLicenseServers 属性是由服务器配置的还是由组策略配置的。

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceDisableForcibleLogoff

数据类型： uint32

访问类型：只读

不支持此属性。

Windows Server 2008： 确定 DisableForcibleLogoff 属性是由服务器还是由组策略配置。

0

服务器

1

组策略。

PolicySourceEnableAutomaticReconnection

数据类型： uint32

访问类型：只读

指示 EnableAutomaticReconnection 属性是由服务器还是组策略配置。

0 (0x0)

服务器

1 (0x1)

组策略

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

PolicySourceEnableDFSS

数据类型： uint32

访问类型：只读

指示 EnableDFSS 属性是由服务器还是组策略配置。

0 (0x0)

服务器

1 (0x1)

组策略

Windows Server 2008： 此属性在 Windows Server 2008 R2 之前不可用。

PolicySourceEnableRemoteDesktopMSI

数据类型： uint32

访问类型：只读

指示 EnableRemoteDesktopMSI 属性是由服务器还是组策略配置。

0 (0x0)

服务器

1 (0x1)

组策略

Windows Server 2008： 此属性在 Windows Server 2008 R2 之前不可用。

PolicySourceFallbackPrintDriverType

数据类型： uint32

访问类型：只读

指示 FallbackPrintDriverType 属性是由服务器还是由组策略配置。

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceHomeDirectory

数据类型： uint32

访问类型：只读

指示 HomeDirectory 属性是由服务器还是由组策略配置。

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceLicensingType

数据类型： uint32

访问类型：只读

指示是按服务器还是组策略配置 LicensingType 属性。

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceProfilePath

数据类型： uint32

访问类型：只读

指示 ProfilePath 属性是由服务器配置的还是由组策略配置的。

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceRedirectSmartCards

数据类型： uint32

访问类型：只读

指示 RedirectSmartCards 属性是由服务器还是组策略配置。

0 (0x0)

服务器

1 (0x1)

组策略

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

PolicySourceSingleSession

数据类型： uint32

访问类型：只读

指示属性 SingleSession 是由服务器配置还是由组策略配置。

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceTimeZoneRedirection

数据类型： uint32

访问类型：只读

指示属性 TimeZoneRedirection 是由服务器还是由组策略配置。

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceUseRDEasyPrintDriver

数据类型： uint32

访问类型：只读

指示 UseRDEasyPrintDriver 属性是由服务器还是组策略配置。

0 (0x0)

服务器

1 (0x1)

组策略

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

PolicySourceUseTempFolders

数据类型： uint32

访问类型：只读

指示 UseTempFolders 属性是由服务器还是按组策略配置。

0 (0x0)

服务器

1 (0x1)

组策略

PossibleLicensingTypes

数据类型： uint32

访问类型：只读

限定符： BitMap (“0”、“1”、“2”、“4”、“5”) 、 BitValues (“个人终端服务器”、“远程桌面管理”、“每设备”、“每个用户”、“未配置”)

一个位掩码，指定可用的许可类型。 这可以是以下一个或多个值的组合。

1 (0x1)

支持个人 RD 会话主机服务器许可证。

2 (0x2)

支持远程桌面许可证。

4 (0x4)

支持每个设备许可证。

8 (0x8)

支持每用户许可证。

ProfilePath

数据类型： 字符串

访问类型：只读

计算机的配置文件路径。

RedirectSmartCards

数据类型： uint32

访问类型：读/写

指定是否允许在远程会话中重定向智能卡设备。

0 (0x0)

不允许智能卡设备重定向。

1 (0x1)

允许智能卡设备重定向。

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

ServerName

数据类型： 字符串

访问类型：只读

限定符： 键

其属性感兴趣的 RD 会话主机服务器的名称。

SessionBrokerDrainMode

数据类型： uint32

访问类型：读/写

RD 连接代理用户登录模式。

0

允许所有连接。

1

允许重新连接，但在服务器重启之前阻止新登录。

2

允许重新连接，但阻止新的登录。

SingleSession

数据类型： uint32

访问类型：只读

指定是否允许每个用户使用一个或多个远程桌面服务会话。

false (0)

每个用户允许多个会话。

True (1)

每个用户只允许一个会话。

Status

数据类型： 字符串

访问类型：只读

限定符： MaxLen (10)

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

此属性继承自 CIM_ManagedSystemElement。

(“确定”)

(“错误”)

(“已降级”)

(“未知”)

(“Pred Fail”)

(“启动”)

(“停止”)

(“Service”)

TerminalServerMode

数据类型： uint32

访问类型：只读

远程桌面服务服务的 RD 会话主机服务器操作模式。 此模式控制适用的许可策略以及是否启用应用程序兼容性功能。

AppServer (1)

服务器作为应用程序服务器运行。

RemoteAdmin (0)

会话是远程管理的。

TimeZoneRedirection

数据类型： uint32

访问类型：只读

指定客户端计算机是否可以将其时区设置重定向到远程桌面服务会话。

0

重定向已禁用。

1

已启用重定向。

UseRDEasyPrintDriver

数据类型： uint32

访问类型：读/写

指定是否首先使用远程桌面简易打印打印机驱动程序来安装所有客户端打印机。

0

RD 会话主机服务器尝试查找合适的打印机驱动程序来安装客户端打印机。 如果 RD 会话主机服务器没有与客户端打印机匹配的打印机驱动程序，则服务器会尝试使用远程桌面轻松打印驱动程序来安装客户端打印机。

1

RD 会话主机服务器首先尝试使用远程桌面简易打印打印机驱动程序来安装所有客户端打印机。 如果由于任何原因无法使用远程桌面简易打印打印机驱动程序，将使用 RD 会话主机服务器上的与客户端打印机匹配的打印机驱动程序。

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

UserPermission

数据类型： uint32

访问类型：读/写

指定每个用户会话的安全性是严格还是宽松。

FALSE (0)

安全性十分严格。

TRUE (1)

安全是宽松的。

UseTempFolders

数据类型： uint32

访问类型：只读

指定是否按会话创建和删除临时目录。

FALSE (0)

不会为每个会话创建和删除临时目录。 为第一个会话创建一个，永远不会删除。

TRUE (1)

为每个会话创建和删除临时目录。

备注

Win32_TerminalServiceSetting关联到Win32_TerminalService作为Win32_TerminalServiceToSetting关联的 Setting 属性。

Win32_TerminalSetting与Win32_Terminal关联为Win32_TerminalTerminalSetting关联的 Setting 属性。

若要连接到 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 Server 2008
命名空间
 Root\CIMv2\TerminalServices
MOF
TSCfgWmi.mof
DLL
TSCfgWmi.dll

另请参阅

CIM_Setting

Win32_Terminal

Win32_TerminalService

Win32_TerminalServiceToSetting

Win32_TerminalTerminalSetting

CIM_Setting