通过

Win32_TSClientSetting 类

  • 项目

Win32_TSClientSetting WMI 类定义与连接策略相关的Win32_Terminal类的配置设置。

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

语法

[dynamic, provider("Win32_WIN32_TSCLIENTSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSClientSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ConnectionPolicy;
  uint32   ConnectClientDrivesAtLogon;
  uint32   ConnectPrinterAtLogon;
  uint32   DefaultToClientPrinter;
  uint32   PolicySourceDefaultToClientPrinter;
  uint32   WindowsPrinterMapping;
  uint32   PolicySourceWindowsPrinterMapping;
  uint32   LPTPortMapping;
  uint32   PolicySourceLPTPortMapping;
  uint32   COMPortMapping;
  uint32   PolicySourceCOMPortMapping;
  uint32   DriveMapping;
  uint32   PolicySourceDriveMapping;
  uint32   AudioMapping;
  uint32   PolicySourceAudioMapping;
  uint32   ClipboardMapping;
  uint32   PolicySourceClipboardMapping;
  uint32   ColorDepthPolicy;
  uint32   PolicySourceColorDepthPolicy;
  uint32   ColorDepth;
  uint32   PolicySourceColorDepth;
  uint32   MaxMonitors;
  uint32   MaxXResolution;
  uint32   MaxYResolution;
  uint32   PolicySourceMaxMonitors;
  uint32   PolicySourceMaxResolution;
  uint32   PNPRedirection;
  uint32   PolicySourcePNPRedirection;
  uint32   AudioCaptureRedir;
  uint32   PolicySourceAudioCaptureRedir;
  uint32   VideoPlaybackRedir;
  uint32   PolicySourceVideoPlaybackRedir;
  uint32   AllowDwm;
  uint32   PolicySourceAllowDwm;
  uint32   PolicyAdvancedRemoteAppGraphics;
  uint32   AdvancedRemoteAppGraphics;
  uint32   RemoteSessionProfile;
  uint32   PolicySourceRemoteSessionProfile;
  uint32   AVC444ModePreferred;
  uint32   PolicySourceAvc444ModePreferred;
  uint32   EncodeImageQuality;
  uint32   PolicySourceEncodeImageQuality;
  uint32   HardwareGraphicsAdapter;
  uint32   PolicySourceHardwareGraphicsAdapter;
  uint32   SelectTransport;
  uint32   PolicySourceSelectTransport;
  uint32   SelectNetworkDetect;
  uint32   PolicySourceSelectNetworkDetect;
};

成员

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

方法

Win32_TSClientSetting 类具有这些方法。

方法 说明
ConnectionSettings 设置此类的 ConnectClientDrivesAtLogon、 ConnectPrinterAtLogon 和 DefaultToClientPrinter 属性。
SetAllowDwm 不支持。
Windows 7 和 Windows Server 2008 R2： 设置 AllowDwm 属性。
SetClientProperty 设置 LPTPortMapping、 COMPortMapping、 AudioMapping、 剪贴板映射、 DriveMapping 或 WindowsPrinterMapping 属性。
SetColorDepth 设置 ColorDepth 属性。
SetColorDepthPolicy 设置 ColorDepthPolicy 属性。
SetMaxMonitors 设置 MaxMonitors 属性。
SetMaxXResolution 设置 MaxXResolution 属性。
SetMaxYResolution 设置 MaxYResolution 属性。

属性

Win32_TSClientSetting 类具有这些属性。

AdvancedRemoteAppGraphics

数据类型： uint32

访问类型：读/写

指定是否为 RemoteApp 启用高级 RemoteFX 图形。

Windows Server 2012、Windows 8、Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista：此属性在Windows Server 2012 R2 和Windows 8.1之前不可用。

FALSE (0)

禁用高级图形。

TRUE (1)

已启用高级图形。

AllowDwm

数据类型： uint32

访问类型：只读

此属性不可用。

**Windows 7 和 Windows Server 2008 R2： **

指定是启用或禁用远程桌面组合。 零将禁用远程桌面组合，非零值将启用它。

使用 SetAllowDwm 方法修改此属性。

AudioCaptureRedir

数据类型： uint32

访问类型：只读

指定是否允许音频捕获重定向。

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

FALSE (0)

TRUE (1)

AudioMapping

数据类型： uint32

访问类型：只读

指定是禁用还是启用音频映射。

FALSE (0)

音频映射已启用。

TRUE (1)

音频映射已禁用。

AVC444ModePreferred

数据类型： uint32

访问类型：读/写

指定 AVC444 模式是否首选。

Windows 8.1、Windows Server 2012 R2、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此属性在Windows 10或之前不可用Windows Server 2016。

FALSE (0)

TRUE (1)

Caption

数据类型： 字符串

访问类型：只读

限定符： MaxLen (64)

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

此属性继承自 CIM_ManagedSystemElement。

剪贴板映射

数据类型： uint32

访问类型：只读

指定是禁用还是启用剪贴板映射。

FALSE (0)

已启用剪贴板映射。

TRUE (1)

剪贴板映射已禁用。

ColorDepth

数据类型： uint32

访问类型：只读

指定颜色深度。 有关可能的值，请参阅 SetColorDepth 方法。

8 位 (1)

15 位 (2)

16 位 (3)

24 位 (4)

32 位 (5)

ColorDepthPolicy

数据类型： uint32

访问类型：只读

指定是否替代用户的最大颜色设置。

FALSE (0)

不要重写用户的策略。

TRUE (1)

替代用户的策略。

COMPortMapping

数据类型： uint32

访问类型：只读

指定是禁用还是启用 COM 端口映射。

FALSE (0)

已启用 COM 端口映射。

TRUE (1)

COM 端口映射已禁用。

ConnectClientDrivesAtLogon

数据类型： uint32

访问类型：只读

指定是否在登录过程中自动连接客户端的驱动器。

FALSE (0)

驱动器不会自动连接。

TRUE (1)

驱动器将自动连接。

ConnectionPolicy

数据类型： uint32

访问类型：读/写

服务器用于检索用户连接设置的策略。

每个用户 (0)

用户的连接设置有效。

Server-Override (1)

服务器将覆盖用户的连接设置。

ConnectPrinterAtLogon

数据类型： uint32

访问类型：只读

指定是否在登录过程中自动连接客户端的所有映射本地打印机。

FALSE (0)

本地打印机不会自动连接。

TRUE (1)

本地打印机将自动连接。

DefaultToClientPrinter

数据类型： uint32

访问类型：只读

指定打印作业是否自动发送到客户端的本地打印机。

FALSE (0)

打印作业不会自动发送到客户端的本地打印机。

TRUE (1)

打印作业将自动发送到客户端的本地打印机。

描述

数据类型： string

访问类型：只读

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

DriveMapping

数据类型： uint32

访问类型：只读

指定是禁用还是启用驱动器映射。

FALSE (0)

已启用驱动器映射。

TRUE (1)

已禁用驱动器映射。

EncodeImageQuality

数据类型： uint32

访问类型：读/写

指定 RDP 体验的图像质量。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此属性在Windows 8或Windows Server 2012之前不可用。

无损 (1)

高 (2)

中等 (3)

HardwareGraphicsAdapter

数据类型： uint32

访问类型：读/写

指定 RD 会话主机服务器是否使用硬件图形呈现器作为默认适配器。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此属性在Windows 8或Windows Server 2012之前不可用。

FALSE (0)

TRUE (1)

InstallDate

数据类型： datetime

访问类型：只读

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

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

此属性继承自 CIM_ManagedSystemElement。

LPTPortMapping

数据类型： uint32

访问类型：只读

指定是禁用还是启用 LPT 端口映射。

FALSE (0)

LPT 端口映射已启用。

TRUE (1)

LPT 端口映射已禁用。

MaxMonitors

数据类型： uint32

访问类型：只读

服务器支持的最大监视器数。 使用 SetMaxMonitors 方法修改此属性。

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

MaxXResolution

数据类型： uint32

访问类型：只读

服务器支持的最大 X 分辨率。 使用 SetMaxXResolution 方法修改此属性。

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

MaxYResolution

数据类型： uint32

访问类型：只读

服务器支持的最大 Y 分辨率。 使用 SetMaxYResolution 方法修改此属性。

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

名称

数据类型： 字符串

访问类型：只读

对象的名称。

此属性继承自 CIM_ManagedSystemElement。

PNPRedirection

数据类型： uint32

访问类型：只读

指定是否允许即插即用重定向。

FALSE (0)

允许即插即用重定向。

TRUE (1)

不允许即插即用重定向。

PolicyAdvancedRemoteAppGraphics

数据类型： uint32

访问类型：只读

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

Windows Server 2012、Windows 8、Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista：此属性在Windows Server 2012 R2 和Windows 8.1之前不可用。

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceAllowDwm

数据类型： uint32

访问类型：只读

此属性不可用。

**Windows 7 和 Windows Server 2008 R2： **

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

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceAudioCaptureRedir

数据类型： uint32

访问类型：只读

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

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

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceAudioMapping

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

2 (0x2)

默认

PolicySourceAvc444ModePreferred

数据类型： uint32

访问类型：只读

指示 AVC444ModePreferredis 属性的配置方式。

Windows 8.1、Windows Server 2012 R2、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此属性在Windows 10或之前不可用Windows Server 2016。

0

服务器

1

组策略

PolicySourceClipboardMapping

数据类型： uint32

访问类型：只读

指示 剪贴板映射 属性是由服务器、组策略还是默认配置。

0 (0x0)

服务器

1 (0x1)

组策略

2 (0x2)

默认

PolicySourceColorDepth

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

2 (0x2)

默认

PolicySourceColorDepthPolicy

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

2 (0x2)

默认

PolicySourceCOMPortMapping

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

2 (0x2)

默认

PolicySourceDefaultToClientPrinter

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

2 (0x2)

默认

PolicySourceDriveMapping

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

2 (0x2)

默认

PolicySourceEncodeImageQuality

数据类型： uint32

访问类型：只读

指示如何配置 EncodeImageQualityi 。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此属性在Windows 8或Windows Server 2012之前不可用。

0

服务器

1

组策略

PolicySourceHardwareGraphicsAdapter

数据类型： uint32

访问类型：只读

指示 HardwareGraphicsAdapter 的配置方式。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此属性在Windows 8或Windows Server 2012之前不可用。

0

服务器

1

组策略

PolicySourceLPTPortMapping

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

2 (0x2)

默认

PolicySourceMaxMonitors

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

2 (0x2)

默认

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

PolicySourceMaxResolution

数据类型： uint32

访问类型：只读

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

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

0 (0x0)

服务器

1 (0x1)

组策略

2 (0x2)

默认

PolicySourcePNPRedirection

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceRemoteSessionProfile

数据类型： uint32

访问类型：只读

指示 如何配置 RemoteSessionProfile 。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此属性在Windows 8或Windows Server 2012之前不可用。

0

服务器

1

组策略

PolicySourceSelectNetworkDetect

数据类型： uint32

访问类型：只读

指示如何配置 属性 SelectNetworkDetect 。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此属性在Windows 8或Windows Server 2012之前不可用。

0

服务器

1

组策略

PolicySourceSelectTransport

数据类型： uint32

访问类型：只读

指示如何配置 SelectTransport 属性。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此属性在Windows 8或Windows Server 2012之前不可用。

0

服务器

1

组策略

PolicySourceVideoPlaybackRedir

数据类型： uint32

访问类型：只读

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

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

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceWindowsPrinterMapping

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

2 (0x2)

默认

RemoteSessionProfile

数据类型： uint32

访问类型：读/写

指定 RDP 体验的配置文件。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此属性在Windows 8或Windows Server 2012之前不可用。

scale (1)

体验 (2)

带宽 (3)

SelectNetworkDetect

数据类型： uint32

访问类型：读/写

指定是否使用网络检测。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此属性在Windows 8或Windows Server 2012之前不可用。

0

在连接时使用且处于稳定状态。

1

在连接时禁用

2

在稳定状态下禁用

3

在连接时处于稳定状态时禁用。

SelectTransport

数据类型： uint32

访问类型：读/写

指定哪些传输协议可用于对服务器的 RDP 访问。

Windows 7、Windows Server 2008 R2、Windows Vista 和 Windows Server 2008：此属性在Windows 8或Windows Server 2012之前不可用。

0

同时使用 UDP 和 TCP。

1

仅使用 TCP。

2

使用 UDP 或 TCP。

Status

数据类型： string

访问类型：只读

限定符： MaxLen (10)

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

此属性继承自 CIM_ManagedSystemElement。

(“OK”)

(“Error”)

(“已降级”)

(“未知”)

(“Pred Fail”)

(“Starting”)

(“停止”)

(“Service”)

TerminalName

数据类型： string

访问类型：只读

终端的名称。

此属性继承自 Win32_TerminalSetting。

VideoPlaybackRedir

数据类型： uint32

访问类型：只读

指定是否允许视频播放重定向。

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

FALSE (0)

TRUE (1)

WindowsPrinterMapping

数据类型： uint32

访问类型：只读

指定是否为客户端窗口禁用或启用打印机映射。

FALSE (0)

已启用打印机映射。

TRUE (1)

打印机映射已禁用。

备注

请注意，与控制台会话关联的窗口工作站无法访问此类的方法和属性。 如果尝试通过将“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_Terminal

Win32_TerminalSetting

CIM_Setting