Win32_TSDeploymentSettings 类

项目
06/12/2023

定义 RemoteApp 管理器在创建远程桌面协议时使用的默认设置， (RDP) 文件。这些设置不会影响任何已发布的应用程序或桌面。

语法

class Win32_TSDeploymentSettings : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  sint32   Port;
  string   FarmName;
  sint32   GatewayUsage;
  string   GatewayName;
  sint32   GatewayAuthMode;
  boolean  GatewayUseCachedCreds;
  boolean  RequireServerAuth;
  sint32   ColorBitDepth;
  boolean  AllowFontSmoothing;
  boolean  UseMultimon;
  sint32   RedirectionOptions;
  boolean  HasCertificate;
  uint8    CertificateHash[];
  string   CertificateIssuedTo;
  string   CertificateIssuedBy;
  string   CertificateExpiresOn;
  string   CustomRDPSettings;
  string   DeploymentRDPSettings;
};

成员

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

属性

属性

Win32_TSDeploymentSettings 类具有这些属性。

AllowFontSmoothing

数据类型： 布尔值
访问类型：读/写

指示是否允许字体平滑。

Caption

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

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

此属性继承自 CIM_ManagedSystemElement。

CertificateExpiresOn

数据类型： 字符串
访问类型：读/写

证书过期的日期。此值存储为 64 位 FILETIME 格式。

CertificateHash

数据类型： uint8 数组
访问类型：读/写

用于对 RDP 文件进行签名的证书的指纹。

CertificateIssuedBy

数据类型： 字符串
访问类型：读/写

指定证书的颁发者。

CertificateIssuedTo

数据类型： 字符串
访问类型：读/写

指定证书颁发给谁。

ColorBitDepth

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

显示器的颜色位深度。可能的值为 4、8、15、16、24 和 32。

CustomRDPSettings

数据类型： 字符串
访问类型：读/写

与 RemoteApp Manager 中的自定义 RDP 设置相对应的 RDP 文件的内容。

DeploymentRDPSettings

数据类型： 字符串
访问类型：读/写

与 RemoteApp Manager 中的部署设置对应的 RDP 文件的内容。如果设置了此值，RDP 部署设置将取代此类中的默认设置。例如，如果在此类中设置 GatewayAuthMode 属性，并设置 DeploymentRDPSettings 属性，则将忽略此类中的 GatewayAuthMode 属性，并使用 DeploymentRDPSettings 中的GatewayAuthMode 值。

描述

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

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

FarmName

数据类型： 字符串
访问类型：读/写

RD 会话主机服务器的名称，或 RD 会话主机服务器场的 FQDN) (完全限定的域名。

GatewayAuthMode

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

RD 网关身份验证方法。可以使用以下值。

0

密码

1

智能卡

4

允许用户在连接期间选择。

GatewayName

数据类型： 字符串
访问类型：读/写

要使用的 RD 网关服务器的名称。

GatewayUsage

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

指示是否使用 RD 网关服务器通过防火墙连接到目标 RD 会话主机服务器。可以使用以下值。

请勿使用 RD 网关服务器。

使用 RD 网关服务器。绕过本地地址的 RD 网关服务器。

使用 RD 网关服务器。

自动检测 RD 网关服务器设置。

GatewayUseCachedCreds

数据类型： 布尔值
访问类型：读/写

如果可能，请对 RD 网关服务器和 RD 会话主机服务器使用相同的用户凭据。

HasCertificate

数据类型： 布尔值
访问类型：读/写

指示是否使用证书对 RDP 文件进行签名。

InstallDate

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

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

此属性继承自 CIM_ManagedSystemElement。

名称

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

对象的名称。

此属性继承自 CIM_ManagedSystemElement。

端口

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

要使用的 RDP 端口。

重定向选项

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

指定 RemoteApp 连接的设备和资源重定向选项。可以组合 重定向选项的 标志。可以使用以下值。

无设备或资源重定向。

重定向磁盘驱动器。

重定向打印机。

重定向剪贴板。

重定向受支持的即插即用设备。

重定向智能卡。

重定向音频。

重定向串行端口。

RequireServerAuth

数据类型： 布尔值
访问类型：读/写

指示是否要求服务器身份验证。

Status

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

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

此属性继承自 CIM_ManagedSystemElement。

(“确定”)

(“错误”)

(“已降级”)

(“未知”)

(“Pred Fail”)

(“启动”)

(“停止”)

(“Service”)

UseMultimon

数据类型： 布尔值
访问类型：读/写

指示是否为桌面启用了多个监视器。

备注

你必须是管理员组的成员才能使用此类设置属性。

如果 RequireServerAuth 设置为 TRUE，请考虑以下事项：

如果 RemoteApp 程序用于 Intranet，并且所有客户端计算机都运行 Windows Server 2008 或 Windows Vista，则无需将 RD 会话主机服务器配置为使用 SSL 证书。在这种情况下，应使用网络级身份验证。
必须为 FarmName 属性的值指定服务器或场的 FQDN。

若要连接到“CIMV2\TerminalServices”命名空间，身份验证级别必须包含数据包隐私。对于 C/C++ 调用，这是 RPC_C_AUTHN_LEVEL_PKT_PRIVACY的身份验证级别，可以使用 CoSetProxyBlanket COM 函数进行设置。对于 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 文件的详细信息，请参阅托管对象格式 (MOF) 。

要求

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

通过

Win32_TSDeploymentSettings 类

语法

成员

属性

备注

要求

反馈

其他资源