Win32_TSEnvironmentSetting 类

  • 项目

Win32_TSEnvironmentSetting WMI 类定义Win32_Terminal类的配置设置，包括初始程序策略。

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

语法

[dynamic, provider("Win32_WIN32_TSENVIRONMENTSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSEnvironmentSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  uint32   ClientWallPaper;
  string   InitialProgramPath;
  uint32   InitialProgramPolicy;
  uint32   PolicySourceClientWallPaper;
  uint32   PolicySourceInitialProgramPath;
  uint32   PolicySourceStartIn;
  string   Startin;
};

成员

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

方法

Win32_TSEnvironmentSetting 类具有这些方法。

方法 说明
InitialProgram 设置此类中包含的启动程序属性。
SetClientWallPaper 设置 ClientWallPaper 属性。

属性

Win32_TSEnvironmentSetting 类具有这些属性。

Caption

数据类型： 字符串

访问类型：只读

限定符： MaxLen (64)

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

此属性继承自 CIM_ManagedSystemElement。

ClientWallPaper

数据类型： uint32

访问类型：只读

指定是否在客户端上显示壁纸图像。 不显示壁纸图像可以减少重新绘制屏幕所需的时间，从而节省系统资源。

false (0)

壁纸图像不显示在客户端上。

True (1)

壁纸图像显示在客户端上。

描述

数据类型： 字符串

访问类型：只读

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

InitialProgramPath

数据类型： 字符串

访问类型：只读

用户登录到 RD 会话主机服务器后将立即运行的程序的名称和路径。

InitialProgramPolicy

数据类型： uint32

访问类型：读/写

服务器用于确定启动程序路径和文件名的策略，以及它所在的文件夹的名称。

每个用户 (0)

用户的启动程序设置有效。

服务器替代 (1)

服务器将覆盖用户的启动程序设置。

单应用模式 (2)

此会话中只会运行一个应用程序。 启动程序信息将被忽略。

InstallDate

数据类型： datetime

访问类型：只读

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

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

此属性继承自 CIM_ManagedSystemElement。

名称

数据类型： 字符串

访问类型：只读

对象的名称。

此属性继承自 CIM_ManagedSystemElement。

PolicySourceClientWallPaper

数据类型： uint32

访问类型：只读

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

0

服务器

1

组策略

2

默认

PolicySourceInitialProgramPath

数据类型： uint32

访问类型：只读

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

0

服务器

1

组策略

2

默认

PolicySourceStartIn

数据类型： uint32

访问类型：只读

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

0

服务器

1

组策略

2

默认

Startin

数据类型： string

访问类型：只读

用户登录到 RD 会话主机服务器后将立即运行的程序的工作目录的路径。

Status

数据类型： string

访问类型：只读

限定符： MaxLen (10)

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

此属性继承自 CIM_ManagedSystemElement。

(“OK”)

(“Error”)

(“已降级”)

(“未知”)

(“Pred Fail”)

(“Starting”)

(“停止”)

(“Service”)

TerminalName

数据类型： string

访问类型：只读

终端的名称。

此属性继承自 Win32_TerminalSetting。

备注

请注意，与控制台会话关联的 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