Msvm_TerminalService 类

管理与特定主机的所有远程终端连接。 该服务使用可配置的端口来启动所有终端连接。

以下语法是简化的托管对象格式 (MOF) 代码,它包括所有继承的属性。

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_TerminalService : CIM_Service
{
  string   InstanceID;
  string   Caption = "Hyper-V Terminal Service";
  string   Description = "Microsoft Virtual Terminal Service";
  string   ElementName = "Hyper-V Terminal Service";
  datetime InstallDate;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "The virtual terminal connection management service is fully operational" };
  string   Status = "OK";
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   Name = "termsvc";
  string   CreationClassName = "Msvm_TerminalService";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   StartMode;
  boolean  Started;
};

成员

Msvm_TerminalService 类具有以下类型的成员:

方法

Msvm_TerminalService 类具有这些方法。

方法 说明
GetInteractiveSessionACL 检索控制对虚拟机交互式会话的访问的当前 DACL。
GrantInteractiveSessionAccess 向指定的受托人列表授予对虚拟机交互式会话的访问权限。
ModifyServiceSettings 修改服务的设置数据。
RequestStateChange 请求状态更改。
RevokeInteractiveSessionAccess 从指定的受托人列表中撤消对虚拟机交互式会话的访问权限。
StartService 启动服务。
StopService 停止服务。

属性

Msvm_TerminalService 类具有这些属性。

AvailableRequestedStates

数据类型: uint16 数组

访问类型:只读

指示 RequestStateChange 方法的 RequestedState 参数的可能值。 此属性继承自 CIM_EnabledLogicalElement

Caption

数据类型: 字符串

访问类型:只读

对象的简短说明。 此属性继承自 CIM_ManagedElement

CommunicationStatus

数据类型: uint16

访问类型:只读

指示检测与基础托管元素通信的能力。 Null 值表示未实现此属性。 此属性继承自 CIM_ManagedSystemElement

未知 (0)

不可用 (1)

通信正常 (2)

丢失通信 (3)

无联系人 (4)

DMTF 保留 (.)

供应商预留 (0x8000。)

CreationClassName

数据类型: 字符串

访问类型:只读

创建实例时使用的类或子类的名称。 此属性继承自 CIM_Service

描述

数据类型: 字符串

访问类型:只读

对象的说明。 此属性继承自 CIM_ManagedElement

DetailedStatus

数据类型: uint16

访问类型:只读

Compliment the PrimaryStatus property with additional status detail. Null 值表示未实现此属性。 此属性继承自 CIM_ManagedSystemElement

不可用 (0)

无其他信息 (1)

压力 (2)

预测故障 (3)

不可恢复的错误 (4)

错误 (5) 中的支持实体

DMTF 保留 (.)

供应商预留 (0x8000。)

ElementName

数据类型: 字符串

访问类型:只读

对象的显示名称。 此属性继承自 CIM_ManagedElement

EnabledDefault

数据类型: uint16

访问类型:只读

元素的已启用状态的管理员默认或启动配置。 此属性继承自 CIM_EnabledLogicalElement

EnabledState

数据类型: 字符串

访问类型:只读

元素的启用和禁用状态。 它还可以指示这些请求状态之间的转换。 此属性继承自 CIM_EnabledLogicalElement

HealthState

数据类型: uint16

访问类型:只读

元素的当前运行状况。 此属性表示此元素的运行状况,但不一定表示其子组件的运行状况。 可能的值为 0 到 30,其中 5 表示元素完全正常运行,30 表示元素完全无功能。 此属性继承自 CIM_ManagedSystemElement

InstallDate

数据类型: datetime

访问类型:只读

创建虚拟机配置的日期和时间。 此属性继承自 CIM_ManagedSystemElement

InstanceID

数据类型: 字符串

访问类型:只读

限定符:

唯一标识此类的实例。 此属性继承自 CIM_ManagedElement,并且始终设置为 Null

名称

数据类型: 字符串

访问类型:只读

对象的已知标签。 此属性继承自 CIM_Service

OperatingStatus

数据类型: uint16

访问类型:只读

提供元素操作条件的当前状态信息,并可用于提供有关 EnabledState 属性值的更多详细信息。 Null 值表示未实现此属性。 此属性继承自 CIM_ManagedSystemElement

未知 (0)

不可用 (1)

服务 (2)

(3)

停止 (4)

已停止 (5)

已中止 (6)

休眠 (7)

已完成 (8)

迁移 (9)

移民 (10)

移民 (11)

快照 (12)

关闭 (13)

在测试 (14)

转换 (15)

在服务 (16)

DMTF 保留 (.)

供应商预留 (0x8000。)

OperationalStatus

数据类型: uint16 数组

访问类型:只读

对象的当前状态。 此属性继承自 CIM_ManagedSystemElement

OtherEnabledState

数据类型: 字符串

访问类型:只读

一个字符串,描述 EnabledState 属性设置为 1 时元素的启用或禁用状态 (其他) 。 如果 EnabledState 为除 1 以外的任何值,则必须将此属性设置为 Null。 此属性继承自 CIM_EnabledLogicalElement

PrimaryOwnerContact

数据类型: 字符串

访问类型:只读

一个 值,该值提供有关如何联系服务的主要所有者的信息, (例如电话号码、电子邮件地址等) 。 此属性继承自 CIM_Service

PrimaryOwnerName

数据类型: 字符串

访问类型:只读

服务的主要所有者的名称(如果已定义)。 主要所有者是该服务的初始支持联系人。 此属性继承自 CIM_Service

PrimaryStatus

数据类型: uint16

访问类型:只读

提供高级状态信息。 此属性应与 DetailedStatus 属性结合使用,以提供元素及其子组件的高级和详细的运行状况状态。 Null 值表示未实现此属性。 此属性继承自 CIM_ManagedSystemElement

未知 (0)

正常 (1)

降级 (2)

错误 (3)

DMTF 保留 (.)

供应商预留 (0x8000。)

RequestedState

数据类型: uint16

访问类型:只读

元素的最后一个请求或所需状态。 元素的实际状态由 EnabledState 表示。 提供此属性用于比较上次请求的状态和当前启用或禁用的状态。 CIM_EnabledLogicalElement 的特定实例可能不支持 RequestStateChange 方法。 如果发生这种情况,则使用值 12 (不适用) 。 此属性继承自 CIM_EnabledLogicalElement

已开始

数据类型: 布尔值

访问类型:只读

指示服务当前是否正在运行。 此属性继承自 CIM_Service

StartMode

数据类型: 字符串

访问类型:只读

一个字符串值,该值指示服务是由系统、操作系统自动启动还是仅在请求时启动。 此属性继承自 CIM_Service

Status

数据类型: 字符串

访问类型:只读

元素的状态。 此属性继承自 CIM_ManagedSystemElement

StatusDescriptions

数据类型: 字符串 数组

访问类型:只读

描述各种 OperationalStatus 数组值的字符串。 此属性继承自 CIM_ManagedSystemElement

SystemCreationClassName

数据类型: 字符串

访问类型:只读

范围系统的创建类名称。 此属性继承自 CIM_Service

SystemName

数据类型: 字符串

访问类型:只读

宿主计算机系统的名称。 此属性继承自 CIM_Service

TimeOfLastStateChange

数据类型: datetime

访问类型:只读

元素的启用状态上次更改的日期或时间。 此属性继承自 CIM_EnabledLogicalElement

TransitioningToState

数据类型: uint16

访问类型:只读

指示实例转换到的目标状态。 此属性继承自 CIM_EnabledLogicalElement

备注

UAC 筛选可能会限制对 Msvm_TerminalService 类的访问。 有关详细信息,请参阅 用户帐户控制和 WMI

要求

要求
最低受支持的客户端
Windows 8 [仅限桌面应用]
最低受支持的服务器
Windows Server 2012 [仅限桌面应用]
命名空间
Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

另请参阅

CIM_Service