通过

Win32_TSSessionDirectory 类

  • 项目

为 Win32_TSSessionDirectorySetting 类定义 远程桌面连接代理 (RD 连接代理) 配置设置。

注意

在 Windows Server 2008 R2 中，终端服务会话代理 (TS 会话代理) 的名称已更改为 RD 连接代理。 除非另有说明，否则这些属性适用于所有受支持的操作系统。

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

语法

[dynamic, provider("Win32_WIN32_TSSESSIONDIRECTORY_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TSSessionDirectory : CIM_Setting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   SessionDirectoryLocation;
  uint32   PolicySourceSessionDirectoryLocation;
  uint32   SessionDirectoryActive;
  uint32   PolicySourceSessionDirectoryActive;
  uint32   SessionDirectoryExposeServerIP;
  uint32   PolicySourceSessionDirectoryExposeServerIP;
  string   SessionDirectoryClusterName;
  uint32   PolicySourceLoadBalancing;
  uint32   GetLoadBalancingState;
  uint32   GetServerWeight;
  uint32   PolicySourceSessionDirectoryClusterName;
  string   SessionDirectoryIPAddress;
  uint32   GetTSRedirectorMode;
  uint32   PolicySourceTSRedirectorMode;
};

成员

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

方法

Win32_TSSessionDirectory 类具有这些方法。

方法 说明
CreateUserDiskTemplate 创建用户磁盘模板。
DisableUserVhd 禁用用户配置文件 VHD。
EnableUserVhd 在 RDSH 服务器上启用用户配置文件 VHD。
GetCurrentRedirectableAddresses 获取当前配置的 DNS 合格地址列表和重定向类型。
GetRedirectableAddresses 获取符合 DNS 条件的地址的完整列表。
PingSessionDirectory 检查 RD 连接代理服务器是否可用。
SetCurrentRedirectableAddresses 设置配置的 DNS 合格地址列表和重定向类型。
SetLoadBalancingState 设置值以指示服务器是否将参与 RD 连接代理负载均衡。
SetServerWeight 设置 RD 连接代理负载均衡的服务器权重值。
SetSessionDirectoryActive 禁用并启用 RD 连接代理。
SetSessionDirectoryExposeServerIP 设置 SessionDirectoryExposeServerIP 属性。
SetSessionDirectoryProperty 设置 SessionDirectoryLocation 属性或 SessionDirectoryClusterName 属性。
SetTSRedirectorMode 此方法不可用。

属性

Win32_TSSessionDirectory 类具有这些属性。

Caption

数据类型： string

访问类型：只读

限定符： MaxLen (64)

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

此属性继承自 CIM_ManagedSystemElement。

描述

数据类型： string

访问类型：只读

对象的说明。

此属性继承自 CIM_ManagedSystemElement。

GetLoadBalancingState

数据类型： uint32

访问类型：只读

指示服务器是否已配置为参与 RD 连接代理负载均衡。

0

服务器未配置为参与 RD 连接代理负载均衡。

1

服务器配置为参与 RD 连接代理负载均衡。

GetServerWeight

数据类型： uint32

访问类型：只读

检索 RD 连接代理负载均衡中使用的服务器权重值。

GetTSRedirectorMode

数据类型： uint32

访问类型：只读

指示服务器是否配置为充当远程桌面服务重定向程序。

0

服务器配置为充当远程桌面服务重定向程序。

1

服务器未配置为充当远程桌面服务重定向程序。

Windows Server 2008： 此属性不可用。

InstallDate

数据类型： datetime

访问类型：只读

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

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

此属性继承自 CIM_ManagedSystemElement。

名称

数据类型： string

访问类型：只读

对象的名称。

此属性继承自 CIM_ManagedSystemElement。

PolicySourceLoadBalancing

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceSessionDirectoryActive

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceSessionDirectoryClusterName

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceSessionDirectoryExposeServerIP

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceSessionDirectoryLocation

数据类型： uint32

访问类型：只读

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

0 (0x0)

服务器

1 (0x1)

组策略

PolicySourceTSRedirectorMode

数据类型： uint32

访问类型：只读

此属性不可用。

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

0 (0x0)

服务器

1 (0x1)

组策略

SessionDirectoryActive

数据类型： uint32

访问类型：只读

限定符： 键

指定远程桌面服务是否参与 RD 连接代理。

FALSE (0)

远程桌面服务参与 RD 连接代理处于禁用状态。

TRUE (1)

已启用远程桌面服务参与 RD 连接代理。

SessionDirectoryClusterName

数据类型： 字符串

访问类型：只读

RD 会话主机服务器所属的群集的虚拟 IP 地址。

SessionDirectoryExposeServerIP

数据类型： uint32

访问类型：只读

指定是否允许检索 RD 连接代理的 IP 地址。

FALSE (0)

检索被拒绝。

TRUE (1)

允许检索。

SessionDirectoryIPAddress

数据类型： 字符串

访问类型：读/写

会话目录使用的 LAN 适配器的 IP 地址。

SessionDirectoryLocation

数据类型： 字符串

访问类型：只读

运行 RD 连接代理服务的服务器的网络 DNS 名称或 IP 地址。

Status

数据类型： 字符串

访问类型：只读

限定符： MaxLen (10)

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

此属性继承自 CIM_ManagedSystemElement。

(“确定”)

(“错误”)

(“已降级”)

(“未知”)

(“Pred Fail”)

(“启动”)

(“停止”)

(“Service”)

备注

若要连接到 \\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")

在 Windows Server 2008 中，终端服务会话目录功能的名称已更改为终端服务会话代理。

在 Windows Server 2008 R2 中，终端服务会话代理功能的名称已更改为远程桌面连接代理。

托管对象格式 (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_TSSessionDirectorySetting