Win32_TerminalServiceSetting类

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

以下语法通过 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 设置下列属性之一: DeleteTempFoldersUseTempFolders
SetPrimaryLicenseServer 将给定的许可证服务器设置为指定许可证服务器列表中的第一个条目。
SetProfilePath 设置 ProfilePath 属性。
SetSingleSession 设置 SingleSession 属性。
SetSpecifiedLicenseServerList 更新指定许可证服务器的列表,替换任何现有的指定许可证服务器。
SetTimeZoneRedirection 设置 TimeZoneRedirection 属性。
UpdateDirectConnectLicenseServer 更新发现许可证服务器列表。

属性

Win32_TerminalServiceSetting类具有这些属性。

ActiveDesktop

数据类型: uint32

访问类型:读/写

指定是否在每个用户会话中允许活动桌面。

TRUE (0)

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

FALSE (1)

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

AllowTSConnections

数据类型: uint32

访问类型:只读

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

FALSE (0)

不允许使用新连接。

TRUE (1)

允许新连接。

Caption

数据类型: 字符串

访问类型:只读

限定符: MaxLen (64)

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

此属性继承自 CIM_ManagedSystemElement

DeleteTempFolders

数据类型: uint32

访问类型:只读

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

FALSE (0)

禁用删除临时目录。

TRUE (1)

启用临时目录删除。

说明

数据类型: 字符串

访问类型:只读

对象的说明。

此属性继承自 CIM_ManagedSystemElement

DirectConnectLicenseServers

数据类型: 字符串

访问类型:只读

限定符: 已弃用

此属性不可用。

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)

已启用

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

FallbackPrintDriverType

数据类型: uint32

访问类型:只读

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

无回退 dirvers=0 (0)

无回退驱动程序。

最佳猜测=1 (1)

最佳猜测。

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

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

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

最佳猜测。 如果未找到匹配项,则回退到 Postscript (PS) 。

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

最佳猜测。 如果未找到匹配项,则同时显示 PS 和 PCL 驱动程序。

GetCapabilitiesID

数据类型: uint32

访问类型:只读

提供程序的功能 ID。

HomeDirectory

数据类型: 字符串

访问类型:只读

计算机的根目录。

InstallDate

数据类型: datetime

访问类型:只读

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

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

此属性继承自 CIM_ManagedSystemElement

LicensingDescription

数据类型: 字符串

访问类型:只读

许可模式的简要说明。

LicensingName

数据类型: 字符串

访问类型:只读

许可模式的名称。

LicensingType

数据类型: uint32

访问类型:只读

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

个人终端服务器 (0)

个人 RD 会话主机服务器。

用于管理的远程桌面 (1)

用于管理的远程桌面。

每个设备 (2)

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

每个用户 (3)

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

未配置 (4)

未配置。

LimitedUserSessions

数据类型: uint32

访问类型:读/写

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

注意

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

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

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

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

0

此功能已禁用。

1 或更高版本

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

登录

数据类型: 字符串

访问类型:读/写

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

0

允许新会话。

1

不允许使用新会话。

名称

数据类型: 字符串

访问类型:只读

对象的名称。

此属性继承自 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)

对象的当前状态。 可以定义各种操作和非操作状态。 操作状态包括:“OK”、“已降级”和“Pred Fail” (一个元素(例如启用了 SMART 的硬盘驱动器)可能正常运行,但预测近期) 发生故障。 非操作状态包括:“Error”、“Starting”、“Stopping”和“Service”。 后者(“服务”)可以在磁盘镜像重新银化、重新加载用户权限列表或其他管理工作期间应用。 并非所有此类工作都是在线的,但托管元素既不是“确定”,也不是在其他状态之一。

此属性继承自 CIM_ManagedSystemElement

(“确定”)

(“错误”)

(“已降级”)

(“未知”)

(“Pred Fail”)

(“启动”)

(“停止”)

(“服务”)

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