Win32_TerminalService 类

Win32_TerminalService WMI 类是Win32_Service类的子类。 Win32_TerminalService表示Win32_TerminalServiceToSetting关联的元素属性。

以下语法通过 MOF 代码简化,并按字母顺序包括所有已定义和继承的属性。

语法

[dynamic, provider("Win32_WIN32_TERMINALSERVICE_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TerminalService : Win32_Service
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  uint32   CheckPoint;
  string   CreationClassName;
  boolean  DelayedAutoStart;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ProcessId;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
  uint32   WaitHint;
  uint32   DisconnectedSessions;
  uint32   TotalSessions;
};

成员

Win32_TerminalService类包含以下类型的成员:

方法

Win32_TerminalService类具有这些方法。

方法 说明
更改 修改服务。
ChangeStartMode 修改服务的启动模式。
创建 创建一项新服务。
删除 删除现有服务。
GetSecurityDescriptor 返回控制对服务的访问的安全描述符。
InterrogateService 请求服务将其状态更新到服务管理器。
PauseService 尝试将服务置于暂停状态。
ResumeService 尝试将服务置于恢复状态。
SetSecurityDescriptor 编写一个更新版本的安全描述符,用于控制对服务的访问。
StartService 尝试将服务置于启动状态。
StopService 将服务置于停止状态。
UserControlService 尝试将用户定义的控制代码发送到服务。

属性

Win32_TerminalService类具有这些属性。

AcceptPause

数据类型: 布尔值

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_PAUSE_CONTINUE“) , DisplayName (”服务接受暂停“)

指示是否可以暂停服务。

此属性继承自 Win32_BaseService

AcceptStop

数据类型: 布尔值

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|SERVICE_STATUS|dwControlsAccepted|SERVICE_ACCEPT_STOP“) , DisplayName (”服务接受停止“)

指示是否可以停止服务。

此属性继承自 Win32_BaseService

Caption

数据类型: 字符串

访问类型:只读

限定符: MaxLen (64) 、 DisplayName (“Caption”)

服务一行字符串的简短说明。

此属性继承自 CIM_ManagedSystemElement

检查站

数据类型: uint32

访问类型:只读

限定符:MappingStrings (“Win32API|服务结构|SERVICE_STATUS|dwCheckPoint“) ,DisplayName (”Check Point Count“)

服务定期递增以在长时间启动、停止、暂停或继续操作期间报告其进度的值。 例如,服务在启动时完成其初始化的每个步骤时递增此值。 调用服务操作的用户界面程序使用此值在长时间的操作期间跟踪服务的进度。 此值无效,当服务没有启动、停止、暂停或继续操作挂起时,该值应为零。

此属性继承自 Win32_Service

CreationClassName

数据类型: 字符串

访问类型:只读

限定符: CIM_KeyDisplayName (“类名”)

在创建实例时使用的继承链中显示的第一个具体类的名称。 与类的其他键属性一起使用时,此属性允许唯一标识此类及其子类的所有实例。

此属性继承自 CIM_Service

DelayedAutoStart

数据类型: 布尔值

访问类型:只读

限定符:MappingStrings (“Win32API|服务结构|SERVICE_DELAYED_AUTO_START_INFO|fDelayedAutostart“) ,DisplayName (”延迟自动"开始"菜单“)

如果 为 True,则会在启动其他自动启动服务后启动服务,并出现短延迟。

Windows Server 2012 R2、Windows 8.1、Windows Server 2012、Windows 8、Windows Server 2008 R2、Windows 7、Windows Server 2008 和 Windows Vista:在Windows Server 2016和Windows 10之前不支持属性。

此属性继承自 Win32_Service

说明

数据类型: 字符串

访问类型:只读

限定符: DisplayName (“Description”)

对象的说明。

此属性继承自 CIM_ManagedSystemElement

DesktopInteract

数据类型: 布尔值

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|QUERY_SERVICE_CONFIG|dwServiceType|SERVICE_INTERACTIVE_PROCESS“) , DisplayName (”与桌面交互“)

指示服务是否可以在桌面上创建或与窗口通信,从而以某种方式与用户交互。 交互式服务必须在本地系统帐户下运行。 大多数服务不是交互式服务;也就是说,他们不会以任何方式与用户通信。

此属性继承自 Win32_BaseService

DisconnectedSessions

数据类型: uint32

访问类型:只读

当前服务器上的断开连接会话数。 这些会话可能仍在主动使用服务器资源,但它们当前没有与客户端的网络连接。

DisplayName

数据类型: 字符串

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|QUERY_SERVICE_CONFIG|lpDisplayName“) , DisplayName (”显示名称“)

服务管理单元中查看的服务的名称。 此字符串的最大长度为 256 个字符。 请注意,存储在注册表) 中的显示名称和服务名称 (并不总是相同的。 例如,DHCP 客户端服务具有服务名称 Dhcp,但显示名称 DHCP 客户端。 名称在服务控制管理器中保留大小写。 但是, DisplayName 比较始终不区分大小写。

约束:接受 与 Name 属性相同的值。

示例:“Atdisk”

此属性继承自 Win32_BaseService

ErrorControl

数据类型: 字符串

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|QUERY_SERVICE_CONFIG|dwErrorControl“) , DisplayName (”启动失败严重性“)

如果此服务在启动时无法启动,则错误严重性。 该值指示启动程序在发生故障时执行的操作。 所有的错误都由计算机系统记录。

忽略 (“Ignore”)

不通知用户。

普通 (“普通”)

通知用户。 通常,这是一个显示通知用户问题的消息框。

严重 (“严重”)

使用上一次已知正确的配置重新启动系统。

关键 (“关键”)

系统将尝试使用正确的配置重新启动。 如果服务第二次启动失败,启动会失败。

未知 (“未知”)

错误的严重性未知。

此属性继承自 Win32_BaseService

ExitCode

数据类型: uint32

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|SERVICE_STATUS|dwWin32ExitCode“) , DisplayName (”Exit Code“)

Windows错误代码,用于定义启动或停止服务中遇到的错误。 当错误与此类表示的服务唯一时,此属性设置为 ERROR_SERVICE_SPECIFIC_ERROR (1066) ,并且有关错误的信息在 ServiceSpecificExitCode 属性中可用。 服务将 此值设置为在 运行时NO_ERROR,并在正常终止时再次设置为NO_ERROR。

此属性继承自 Win32_BaseService

InstallDate

数据类型: datetime

访问类型:只读

限定符: MappingStrings (“MIF。DMTF|ComponentID|001.5“) , DisplayName (”安装日期“)

已安装 Date 对象。 此属性不需要一个值来指示对象已安装。

此属性继承自 CIM_ManagedSystemElement

名称

数据类型: 字符串

访问类型:只读

限定符: 密钥

服务的唯一标识符,用于指示所管理的功能。 在对象的 Description 属性中描述了此功能。

此属性继承自 CIM_ManagedSystemElement

PathName

数据类型: 字符串

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|QUERY_SERVICE_CONFIG|lpBinaryPathName“) , DisplayName (”文件路径名称“)

实现服务的服务二进制文件的完全限定路径。

示例:“\SystemRoot\System32\drivers\afd.sys”

此属性继承自 Win32_BaseService

ProcessId

数据类型: uint32

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|SERVICE_STATUS_PROCESS|dwProcessId“) , DisplayName (”Process Id“)

服务的进程标识符。

示例:324

此属性继承自 Win32_Service

ServiceSpecificExitCode

数据类型: uint32

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|SERVICE_STATUS|dwServiceSpecificExitCode“) , DisplayName (”服务器特定的退出代码“)

针对服务启动或停止时发生的错误的特定于服务的错误代码。 退出代码由此类表示的服务定义。 仅当 ExitCode 属性值 ERROR_SERVICE_SPECIFIC_ERROR ( 1066) 时设置此值。

此属性继承自 Win32_BaseService

ServiceType

数据类型: 字符串

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|QUERY_SERVICE_CONFIG|dwServiceType“) , DisplayName (”服务类型“)

用于调用进程的服务的类型。

有效值为:

内核驱动程序 (“内核驱动程序”)

文件系统驱动程序 (“文件系统驱动程序”)

适配器 (“适配器”)

识别器驱动程序 (“识别器驱动程序”)

自己的进程 (“自己的进程”)

共享进程 (“共享进程”)

交互式进程 (“交互式进程”)

此属性继承自 Win32_BaseService

已开始

数据类型: 布尔值

访问类型:只读

限定符: DisplayName (“Started”)

指示服务是否已启动。

此属性继承自 CIM_Service

StartMode

数据类型: 字符串

访问类型:只读

限定符:DisplayName (“"开始"菜单模式”)

Windows基础服务的"开始"菜单模式。

启动 (“启动”)

操作系统加载程序启动的设备驱动程序 (仅适用于驱动程序服务) 。

系统 (“系统”)

操作系统初始化过程启动的设备驱动程序。 此值只对驱动程序服务有效。

自动 (“自动”)

服务将在系统启动期间由服务控制管理器自动启动。 即使用户未登录,自动服务也会启动。

手动 (“手动”)

当进程调用 StartService 方法时,由服务控制管理器启动的服务。 除非用户登录并启动这些服务,否则这些服务不会启动。

禁用 (“Disabled”)

在 StartMode 更改为“自动”或“手动”之前无法启动的服务。

此属性继承自 CIM_Service

StartName

数据类型: 字符串

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|QUERY_SERVICE_CONFIG|lpServiceStartName“) , DisplayName (”启动帐户名称“)

运行服务的帐户名称。 根据服务类型,帐户名称可能采用“DomainName\Username”或 UPN 格式 (“Username@DomainName”) 的形式。 服务进程在运行时使用这两种形式之一进行记录。 如果帐户属于内置域,则可以指定“.\Username”。 对于内核或系统级驱动程序, StartName 包含驱动程序对象名称 (,即“\FileSystem\Rdr”或“\Driver\Xns”) ,I/O 系统用来加载设备驱动程序。 此外,如果指定 NULL ,驱动程序会基于服务名称使用 I/O 系统创建的默认对象名称运行。

示例:“DWDOM\Admin”

此属性继承自 Win32_BaseService

State

数据类型: 字符串

访问类型:读/写

限定符: MappingStrings (“Win32API|服务结构|SERVICE_STATUS|dwCurrentState “) , DisplayName (”State“)

基本服务的当前状态。

有效值为:

已停止 (“已停止 ”)

"开始"菜单挂起 (“"开始"菜单挂起”)

停止挂起 (“停止挂起”)

运行 (“正在运行”)

继续挂起 (“继续挂起”)

暂停挂起 (“暂停挂起”)

已暂停 (“已暂停”)

未知 (“未知”)

Windows Server 2008 和 Windows Vista:此属性在 Windows 7 和 Windows Server 2008 R2 之前是只读的。

此属性继承自 Win32_BaseService

Status

数据类型: 字符串

访问类型:只读

限定符: MaxLen (10) , DisplayName (“Status”)

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

有效值为:

确定 (“确定”)

错误 (“错误”)

降级 (“已降级”)

未知 (“未知”)

Pred Fail (“Pred Fail”)

启动 (“启动”)

停止 (“停止”)

服务 (“服务”)

(“强调 ”)

NonRecover (“NonRecover ”)

无联系人 (“无联系人”)

Lost Comm (“Lost Comm”)

此属性继承自 CIM_ManagedSystemElement

SystemCreationClassName

数据类型: 字符串

访问类型:只读

限定符: 传播 的 (“CIM_System。CreationClassName“) 、 CIM_KeyDisplayName (”System Class Name“)

承载此服务的系统的类型名称。

此属性继承自 CIM_Service

SystemName

数据类型: 字符串

访问类型:只读

限定符:传播的 (“CIM_System。Name“) 、CIM_Key、DisplayName (”System Name“)

承载此服务的系统的名称。

此属性继承自 CIM_Service

TagId

数据类型: uint32

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|QUERY_SERVICE_CONFIG|dwTagId“) , DisplayName (”标记 ID“)

组中此服务的唯一标记值。 值 0 (零) 指示服务没有标记。 标记可用于在加载顺序组中对服务启动进行排序,方法是在位于以下位置的注册表中指定标记顺序向量:

\ HKEY_LOCAL_MACHINE系统\CurrentControlSet\控制\ GroupOrderList

标记仅针对具有启动模式或系统启动模式的内核驱动程序和文件系统驱动程序启动类型服务进行评估。

此属性继承自 Win32_BaseService

TotalSessions

数据类型: uint32

访问类型:只读

当前服务器上的会话总数。 这包括已连接和断开连接的会话。

WaitHint

数据类型: uint32

访问类型:只读

限定符: MappingStrings (“Win32API|服务结构|SERVICE_STATUS|dwWaitHint“) , DisplayName (”估计等待时间“)

挂起的开始、停止、暂停或继续操作所需的估计时间(以毫秒为单位)。 指定时间过后,该服务会用递增的 CheckPoint 值或更改 CurrentStateSetServiceStatus 方法进行下一次调用。 如果 WaitHint 传递指定的时间量,并且 CheckPoint 尚未递增,或者 CurrentState 未更改,则服务控制管理器或服务控制程序假定发生了错误。

此属性继承自 Win32_Service

注解

由于 Win32_TerminalService 类是 Win32_Service 类的子类,因此该类继承 Win32_Service的所有属性和方法。

Win32_TerminalServiceSetting关联到Win32_TerminalService作为Win32_TerminalServiceToSetting关联的 Setting 属性。

Win32_TSSessionDirectory关联到Win32_TerminalService作为Win32_TSSessionDirectorySetting关联的 Setting 属性。

托管对象格式 (MOF) 文件包含Windows Management Instrumentation (WMI) 类的定义。 MOF 文件未作为 Microsoft Windows 软件开发工具包 (SDK) 的一部分安装。 使用服务器管理器添加关联角色时,这些角色安装在服务器上。 有关 MOF 文件的详细信息,请参阅 托管对象格式 (MOF)

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
命名空间
Root\CIMv2
MOF
TSCfgWmi.mof
DLL
TSCfgWmi.dll

另请参阅

Win32_Service

Win32_TerminalServiceToSetting

Win32_TSSessionDirectory

Win32_BaseService

CIM_Service