通过

CIM_ManagedSystemElement 类

CIM_ManagedSystemElement是 System 元素层次结构的基类。 系统的任何可分辨组件都是包含在此类中的候选组件。 系统组件的示例包括：

- 软件组件，例如应用程序服务器、数据库和应用程序

-作系统组件，如文件、进程和线程

- 设备组件，如磁盘驱动器、控制器、处理器和打印机

- 芯片和卡片等物理组件。

以下语法从托管对象格式 （MOF） 代码简化，并包括所有继承的属性。

语法

[UMLPackagePath("CIM::Core::CoreElements"), Abstract, Version("2.22.0"), AMENDMENT]
class CIM_ManagedSystemElement : CIM_ManagedElement
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
};

成员

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

性能

CIM_ManagedSystemElement 类具有以下属性。

标题

数据类型：字符串

访问类型：只读

限定符：MaxLen （64）

Caption 属性是对象的短文本说明（一行字符串）。

此属性继承自 CIM_ManagedElement。

CommunicationStatus

数据类型：uint16

访问类型：只读

CommunicationStatus 指示检测能够与基础 ManagedElement 通信。 CommunicationStatus 由以下值之一组成：未知、无、通信正常、通信丢失或无联系人。

Null 返回指示实现（提供程序）不实现此属性。

“未知”表示实现通常能够返回此属性，但目前无法执行此作。

“不可用”表示实现（提供程序）能够返回此属性的值，但对于此特定硬件/软件片段或属性，不会有意使用，因为它不会添加有意义的信息（如用于向另一属性添加其他信息的属性）。

“通信正常”表示已与元素建立通信，但不传达任何服务质量。

“无联系人”表示监视系统已了解此元素，但从未能够与其建立通信。

“丢失通信”表示已知托管元素存在，并且在过去已成功联系，但目前无法访问。

价值 意义
0
 未知
1
 不可用
2
 通信正常
3
 通信丢失
4
 无联系人
..
 DMTF 保留
0x8000..
 供应商预留

说明

数据类型：字符串

访问类型：只读

Description 属性提供对象的文本说明。

此属性继承自 CIM_ManagedElement。

DetailedStatus

数据类型：uint16

访问类型：只读

限定符：ModelCorrespondence（“CIM_EnabledLogicalElement.PrimaryStatus”、“CIM_ManagedSystemElement.HealthState”）

DetailStatus 对 PrimaryStatus 的补充，并提供了其他状态详细信息。 它包含以下值之一：“不可用”、“无其他信息”、“压力”、“预测失败”、“错误”、“不可恢复错误”、“SupportingEntityInError”。 详细状态用于扩展元素的 PrimaryStatus。

Null 返回指示实现（提供程序）不实现此属性。

“不可用”表示实现（提供程序）能够返回此属性的值，但对于此特定硬件/软件片段或属性，不会有意使用，因为它不会添加有意义的信息（如用于向另一属性添加其他信息的属性）。

“无其他信息”表示该元素正常运行，如 PrimaryStatus = “OK” 指示。

“Stressed”表示该元素正常运行，但需要注意。 “压力”状态的示例包括重载、过热等。

“预测故障”表示元素正常运行，但在不久的将来预测故障。

“不可恢复的错误”表示此元素处于需要人工干预的错误条件。

“支持错误中的实体”表示此元素可能为“正常”，但另一个元素（依赖于该元素）出错。 例如，由于低层网络问题，网络服务或终结点无法正常工作。

价值 意义
0
 不可用
1
 无其他信息
2
 强调
3
 预测失败
4
 不可恢复的错误
5
 支持错误中的实体
..
 DMTF 保留
0x8000..
 供应商预留

ElementName

数据类型：字符串

访问类型：只读

对象的用户友好名称。 此属性允许每个实例定义用户友好名称，以及其关键属性、标识数据和说明信息。

请注意，ManagedSystemElement 的 Name 属性也定义为用户友好名称。 但是，它通常被子类化为键。 不一致的情况下，同一属性可以传达标识和用户友好名称是不合理的。 如果 Name 存在且不是 Key（例如 LogicalDevice 实例），则 Name 和 ElementName 属性中可以同时显示相同的信息。 请注意，如果存在关联的CIM_EnabledLogicalElementCapabilities实例，则此属性的限制可能存在于 ElementNameMask 和在该类中定义的 MaxElementNameLen 属性中。

此属性继承自 CIM_ManagedElement。

HealthState

数据类型：uint16

访问类型：只读

指示元素的当前运行状况。 此属性表示此元素的运行状况，但不一定表示其子组件运行状况。 可能的值为 0 到 30，其中 5 表示元素完全正常，30 表示该元素完全不正常运行。 定义了以下 continuum：

“不可恢复错误”（30） - 该元素已完全失败，并且无法恢复。 此元素提供的所有功能都已丢失。

“严重故障”（25） - 该元素不可正常运行，并且可能无法进行恢复。

“主要故障”（20） - 元素失败。 此组件的某些或全部功能可能已降级或不起作用。

“次要故障”（15） - 所有功能都可用，但有些功能可能会降级。

“已降级/警告”（10） - 元素按工作顺序提供，并且提供所有功能。 但是，该元素无法充分利用其能力。 例如，该元素可能无法以最佳性能运行，也可能报告可恢复的错误。

“OK” （5） - 该元素功能完全正常，在正常作参数中运行且无错误。

“未知”（0） - 目前无法报告 HealthState 的实现。

DMTF 已为将来的其他 HealthStates 保留 continuum 的未使用部分。

价值 意义
0
 未知
5
 还行
10
 已降级/警告
15
 次要失败
20
 主要故障
25
 严重故障
30
 不可恢复的错误
..
 DMTF 保留

InstallDate

数据类型：datetime

访问类型：只读

一个日期/时间值，该值指示何时安装了对象。 缺少值并不表示未安装对象。

InstanceID

数据类型：字符串

访问类型：只读

InstanceID 是一个可选属性，可用于在实例化命名空间范围内不透明且唯一地标识此类的实例。 此类的各种子类可能会重写此属性，使之成为必需项或键。 此类子类还可以修改首选算法，以确保下面定义的唯一性。

为了确保 NameSpace 中的唯一性，应使用以下“首选”算法构造 InstanceID 的值：

<OrgID>：<LocalID>

其中，<OrgID> 和 <LocalID> 由冒号（:)）分隔，其中 <OrgID> 必须包括受版权、商标或其他唯一名称（由正在创建或定义 InstanceID 或由已识别的全局颁发机构分配给业务实体的已注册 ID）。 （此要求类似于架构类名称的 <架构名称>_<类名> 结构。此外，为了确保唯一性，<OrgID> 不得包含冒号（:)）。 使用此算法时，在 InstanceID 中显示的第一个冒号必须出现在 <OrgID> 和 <LocalID>之间。

<LocalID> 由业务实体选择，不应重复使用以标识不同的基础（实际）元素。 如果未为 null 且未使用上述“首选”算法，则定义实体必须确保不会在此实例的 NameSpace 或其他提供程序生成的 InstanceID 中重复使用生成的 InstanceID。

如果未将 DMTF 定义的实例设置为 null，则必须将“首选”算法与设置为 CIM <OrgID> 一起使用。

此属性继承自 CIM_ManagedElement。

名称

数据类型：字符串

访问类型：只读

限定符：MaxLen （1024）

Name 属性定义对象的已知标签。 子类化时，可以将 Name 属性重写为 Key 属性。

OperatingStatus

数据类型：uint16

访问类型：只读

限定符：ModelCorrespondence（“CIM_EnabledLogicalElement.EnabledState”）

OperatingStatus 为元素的作条件提供当前状态值，可用于提供有关 EnabledState 值的更多详细信息。 当元素从一个状态转换到另一个状态（例如，元素在 EnabledState 和 RequestedState 之间转换时）以及其他过渡条件时，它还可以提供过渡状态。

OperatingStatus 由以下值之一组成：未知、不可用、In Service、Starting、Stopping、Stopped、Aborted、Dormant、Completed、Migrating、Emmigrating、Immigrating、Snapshotting。 在测试中关闭

Null 返回指示实现（提供程序）不实现此属性。

“未知”表示实现通常能够返回此属性，但目前无法执行此作。

“None”表示实现（提供程序）能够返回此属性的值，但对于此特定硬件/软件片段，或该属性永远不会被有意使用，因为它不会添加有意义的信息（如用于向另一个属性添加其他信息的属性）。

“服务”描述正在配置、维护、清理或其他管理的元素。

“Starting”描述正在初始化的元素。

“Stoping”描述正被引入有序停止的元素。

“Stoped”和“Aborted”是类似的，尽管前者表示干净有序的停止，而后者意味着突然停止，其中元素的状态和配置可能需要更新。

“休眠”表示元素处于非活动状态或静止状态。

“Completed”表示元素已完成其作。 此值应与 PrimaryStatus 中的“确定”、“错误”或“已降级”组合在一起，以便客户端可以判断完成作是否已完成且“确定”（已传递）、“已完成并出错”或“已完成”（作已完成，但未完成“确定”或未报告错误）。

正在主机元素之间移动“迁移”元素。

“Immigrating”元素正在移动到新的主机元素。

“Emigrating”元素正从主机元素移开。

“关闭”描述了一个突然停止的元素。

“In Test”元素正在执行测试函数。

“转换”描述处于状态之间的元素，即它在其以前的状态或下一个状态中均未完全可用。 如果指示转换为特定状态的其他值不适用，则应使用此值。

“In Service”描述服务和作中的元素。

价值 意义
0
 未知
1
 不可用
2
 服务
3
 开始
4
 停止
5
 停止
6
 中止
7
 睡眠状态的
8
 完成
9
 迁移
10
 移民
11
 移民
12
 快照
13
 关闭
14
 在测试中
15
 转换
16
 在服务中
..
 DMTF 保留
0x8000..
 供应商预留

OperationalStatus

数据类型：uint16 数组

访问类型：只读

限定符：ArrayType（“Indexed”），ModelCorrespondence（“CIM_ManagedSystemElement.StatusDescriptions”）

指示元素的当前状态。 定义了各种作状态。 许多枚举\的值都是自我解释的。 但是，下面详细介绍了一些内容，并对此进行了介绍。

“Stressed”表示该元素正常运行，但需要注意。 “压力”状态的示例包括重载、过热等。

“预测故障”表示元素在名义上正常运行，但在近期预测故障。

“In Service”描述正在配置、维护、清理或其他管理的元素。

“无联系人”表示监视系统已了解此元素，但从未能够与其建立通信。

“丢失通信”表示 ManagedSystem 元素已知存在，并且在过去已成功联系，但当前无法访问。

“Stoped”和“Aborted”是类似的，尽管前者表示干净有序的停止，而后者意味着突然停止，其中元素的状态和配置可能需要更新。

“休眠”表示元素处于非活动状态或静止状态。

“支持错误中的实体”表示此元素可能为“正常”，但另一个元素（依赖于该元素）出错。 例如，由于低层网络问题，网络服务或终结点无法正常工作。

“Completed”表示元素已完成其作。 此值应与“确定”、“错误”或“已降级”组合在一起，以便客户端可以判断完成作是否已完成且“确定”（已传递）、“已完成并出错”或“已完成”（作已完成，但未完成或未报告错误）。

“Power Mode”表示该元素具有关联的 PowerManagementService 关联中包含的其他电源模型信息。

OperationalStatus 替换 ManagedSystemElement 上的 Status 属性，以提供一致的枚举方法，以满足数组属性的实现需求，并提供从当前环境到未来的迁移路径。 此更改之前未进行，因为它需要已弃用的限定符。 由于管理应用程序中广泛使用现有 Status 属性，因此强烈建议提供程序或检测同时提供 Status 和 OperationalStatus 属性。 此外，OperationalStatus 的第一个值应包含元素的主要状态。 检测时，状态（因为它是单值）还应提供元素的主要状态。

价值 意义
0
 未知
1
 其他
2
 还行
3
 退化
4
 强调
5
 预测失败
6
 错误
7
 不可恢复的错误
8
 开始
9
 停止
10
 停止
11
 在服务中
12
 无联系人
13
 通信丢失
14
 中止
15
 睡眠状态的
16
 支持错误中的实体
17
 完成
18
 电源模式
..
 DMTF 保留
0x8000..
 供应商预留

PrimaryStatus

数据类型：uint16

访问类型：只读

限定符：ModelCorrespondence（“CIM_ManagedSystemElement.DetailedStatus”、“CIM_ManagedSystemElement.HealthState”）

PrimaryStatus 提供高级别状态值，旨在与红色Yellow-Green 状态的类型表示形式保持一致。 它应与 DetailedStatus 结合使用，以提供 ManagedElement 及其子组件的高级和详细运行状况。

PrimaryStatus 由以下值之一组成：未知、确定、降级或错误。 “未知”表示实现通常能够返回此属性，但目前无法执行此作。

“OK”表示 ManagedElement 正常运行。

“已降级”表示 ManagedElement 在正常情况下正常运行。

“Error”表示 ManagedElement 处于错误状态。

价值 意义
0
 未知
1
 还行
2
 退化
3
 错误
..
 DMTF 保留
0x8000..
 供应商预留

状态

数据类型：字符串

访问类型：只读

限定符：弃用（“CIM_ManagedSystemElement.OperationalStatus”），MaxLen （10）

一个字符串，指示对象的当前状态。 定义了各种作和非作状态。 此属性不推荐使用 OperationalStatus，该属性在其枚举中包含相同的语义。 此更改有 3 个原因：

  1. 状态更正确地定义为数组。 此定义克服了使用单个值描述状态的限制，当它实际上是多值属性（例如，元素可能为 OK AND Stopped 时）。

  2. MaxLen 的 10 太严格，导致枚举值不清楚。

  3. 定义 CIM V2.0 时讨论了对 uint16 数据类型的更改。 但是，现有的 V1.0 实现使用了字符串属性，并且不想修改其代码。 因此，Status 是架构中的祖父。 使用已弃用的限定符可以维护现有属性，但也允许使用 OperationalStatus 改进的定义。

价值 意义
“确定”
“Error”
“已降级”
“未知”
“Pred Fail”
“正在启动”
“正在停止”
“服务”
“压力”
“NonRecover”
“无联系人”
“Lost Comm”
“已停止”

StatusDescriptions

数据类型：字符串 数组

访问类型：只读

限定符：ArrayType（“Indexed”），ModelCorrespondence（“CIM_ManagedSystemElement.OperationalStatus”）

描述各种 OperationalStatus 数组值的字符串。 例如，如果“Stopping”是分配给 OperationalStatus 的值，则此属性可能包含有关停止对象的原因的说明。 请注意，此数组中的条目与 OperationalStatus 中相同数组索引处的条目相关。

要求
支持的最低客户端
 Windows 10 [仅限桌面应用]
支持的最低服务器
 Windows Server 2016
Namespace
 Root\standardcimv2
MOF
NetEventPacketCapture.mof
DLL
NetEventPacketCapture.dll

另请参阅

CIM_ManagedElement