通过

CIM_LogicalElement 类

  • 项目

系统所有组件的基类，代表抽象系统组件，例如文件、进程或逻辑设备。

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

语法

[UMLPackagePath("CIM::Core::CoreElements"), Abstract, Version("2.6.0"), AMENDMENT]
class CIM_LogicalElement : CIM_ManagedSystemElement
{
  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_LogicalElement 类具有以下类型的成员：

属性

CIM_LogicalElement 类具有这些属性。

Caption

数据类型：string

访问类型：只读

限定符：MaxLen (64)

包含对象的简短文本描述。

此属性继承自 CIM_ManagedElement。

CommunicationStatus

数据类型：uint16

访问类型：只读

指示检测与该元素通信的功能。 NULL 值指示检测不支持此属性。

此属性继承自 CIM_ManagedSystemElement。

值 含义
未知
0
 指示检测目前无法报告 CommunicationStatus 属性。
不可用
1
 指示检测能够报告此属性，但故意不报告该元素的此属性。
通信正常
2
 仅指示与该元素建立通信。
通信中断
3
 指示过去联系过元素，但当前无法访问。
无法联系
4
 指示检测具有此元素的联系信息，但始终无法与其建立通信。
DMTF 保留
5 32767
 保留。
供应商保留
32768 = 值
保留。

描述

数据类型：string

访问类型：只读

提供对象的文本描述。

此属性继承自 CIM_ManagedElement。

DetailedStatus

数据类型：uint16

访问类型：只读

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

指示补充 PrimaryStatus 属性的其他状态详细信息。 NULL 值指示检测不支持此属性。

此属性继承自 CIM_ManagedSystemElement。

值 含义
不可用
0
 指示检测能够报告此属性，但故意不报告该元素的此属性。
无更多信息
1
 指示无需将任何详细信息添加到 PrimaryStatus 属性，例如，当 PrimaryStatus 设置为正常时。
有压力
2
 指示元素正常运行，但需要引起注意。 有压力状态的示例包括重载、过热等。
故障预警
3
 指示某个元素名义上正常运行，但预测在不久的将来会出现故障。
不可恢复的错误
4
 指示此元素处于需要人工干预的错误条件下。
支持实体出错
5
 指示此元素所依赖的元素出错。 此元素可能正常，但由于所依赖元素的状态而无法正常运行。 例如，网络服务或终结点因低层网络问题而无法正常运行。
DMTF 保留
6 32767
 保留。
供应商保留
32768 = 值
保留。

ElementName

数据类型：string

访问类型：只读

包含对象的用户友好名称。 此属性允许每个实例除了定义其关键属性、标识数据和描述信息之外，还定义一个用户友好名称。

此属性继承自 CIM_ManagedElement。

HealthState

数据类型：uint16

访问类型：只读

指示元素当前的健康状况。 此属性表示该元素的健康状况，但不一定表示其子组件的健康状况。

此属性继承自 CIM_ManagedSystemElement。

值 含义
未知
0
 目前，实现无法报告 HealthState。
确定
5
 元素运行完全正常，在正常的运行参数范围内工作，没有出现错误。
已降级/警告
10
 元素正在工作，并且提供所有功能。 但是元素未实现最佳效果。 例如，元素可能未达到最佳性能或报告了可恢复错误
次要故障
15
 所有功能均可以使用，但是有些功能可能已降级。
主要故障
20
 元素失败。 此组件的部分或全部功能已降级或无法使用。
严重故障
25
 元素无法工作，并且可能无法恢复。
不可恢复的错误
30
 元素以失败而告终，并且无法恢复。 此元素提供的所有功能均已丧失。
DMTF 保留
31 = 值
DMTF 保留了连续体中未用的部分，供以后其他 HealthStates 值之用。

InstallDate

数据类型：datetime

访问类型：只读

指示对象的安装时间。 缺少值并不表示未安装对象。

此属性继承自 CIM_ManagedSystemElement。

InstanceID

数据类型：string

访问类型：只读

在包含命名空间的范围内唯一且不透明地标识此类的实例。

[重要提示！]为了确保命名空间中的唯一性，应使用以下模式构造 InstanceID 的值：

OrgID：LocalID

OrgID 必须包含由定义 InstanceID 的业务实体拥有的受版权保护、带商标或唯一名称，或者是由已识别的全局颁发机构分配的已注册 ID。 这类似于 Schema 类名的结构。 此外，为了确保 InstanceID 中的第一个冒号必须位于 OrgID 和 LocalID 之间。 OrgID 不得包含冒号 (':')。

LocalID 由业务实体选择，不应重复使用来标识不同的基础实际元素。

如果不使用前面的模式，则定义实体必须确保生成的 InstanceID 不会在此提供程序或其他提供程序为此命名空间生成的任何 InstanceID 中重复使用。

对于分布式管理任务组 (DMTF) 定义的实例，必须在 OrgID 设置为 CIM 的情况下使用该模式。

此属性继承自 CIM_ManagedElement。

Name

数据类型：string

访问类型：只读

限定符：MaxLen (1024)

指示此作业实例的用户友好名称。 此外，用户友好名称可用作搜索或查询的属性。

[!Tip]
名称在命名空间中不必是唯一的。

此属性继承自 CIM_ManagedSystemElement。

OperatingStatus

数据类型：uint16

访问类型：只读

限定符：ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

指示元素的当前操作条件。 此属性可用于提供有关元素当前状态的更多详细信息。 它还可以指示过渡状态。 NULL 值指示检测不支持此属性。

此属性继承自 CIM_ManagedSystemElement。

值 含义
未知
0
 指示检测目前无法报告 OperatingStatus 属性。
不可用
1
 指示检测能够报告此属性，但故意不报告该元素的此属性。
服务
2
 指示正在对元素进行配置、维护、清理或其他管理操作。
正在启动
3
 指示正在初始化元素。
正在停止
4
 指示正在将元素引入有序停止。
已停止
5
 指示元素是有意停止的。
已中止
6
 指示元素是以意外方式停止的。
休眠
7
 指示元素处于非活动状态或静止状态。
已完成
8
 指示元素已完成其操作。 建议使用 PrimaryStatus 属性值正常、错误或已降级来指示操作成功或失败。
迁移
9
 指示元素正在宿主元素之间移动。
正在迁出
10
 指示元素正在远离宿主元素。
正在迁入
11
 指示元素正在被移动到新的宿主元素。
快照
12
 指示正在创建元素的快照副本。
正在关闭
13
 指示正在突然停止元素。
测试中
14
 指示元素正在执行测试功能。
正在转换
15
 指示元素位于状态之间，并且在任一状态下都不完全可用。 使用另一个指示更具体的转换的值（如果该转换可用）。
服务中
16
 指示正在使用元素，且元素正在运行。
DMTF 保留
17 32767
 保留。
供应商保留
32768 = 值
保留。

OperationalStatus

数据类型：uint16 数组

访问类型：只读

限定符：ArrayType ("Indexed")、ModelCorrespondence ("CIM_ManagedSystemElement.StatusDescriptions")

包含元素当前状态的指示器。 OperationalStatus 的第一个值应包含元素的主要状态。

注意

OperationalStatus 取代了已弃用的 Status 属性。 由于管理应用程序中广泛使用现有的 Status 属性，因此 Microsoft 强烈建议提供程序或检测同时提供 Status 和 OperationalStatus 属性。 受到检测时，Status 还应提供元素的主要状态（因为该属性是单值属性）。

此属性继承自 CIM_ManagedSystemElement。

值 含义
未知
0
 指示实现目前无法报告 OperationalStatus。
其他
1
 指示未定义的状态。
确定
2
 指示功能完整而且没有错误。
已降级
3
 指示元素可正常工作，并提供了所有功能。 但是元素未实现最佳效果。 例如，元素可能未达到最佳性能或报告了可恢复错误
有压力
4
 指示元素正常运行，但需要引起注意。 有压力状态的示例包括重载、过热等。
故障预警
5
 指示某个元素名义上正常运行，但预测在不久的将来会出现故障。
错误
6
 指示发生了错误。
不可恢复的错误
7
 发生了不可恢复的错误。
正在启动
8
 作业正在启动。
正在停止
9
 作业正在停止。
已停止
10
 元素已被有意停止。
服务中
11
 指示正在对元素进行配置、维护、清理或其他管理操作。
无法联系
12
 指示监视系统知道元素，但始终无法与其建立通信。
通信中断
13
 指示已知作业存在并且过去成功联系过，但当前无法访问。
已中止
14
 指示作业以意外方式停止。 可能需要更新作业的状态和配置。
休眠
15
 指示作业处于非活动状态。
支持实体出错
16
 指示此作业所依赖的元素出错。 此元素可能正常，但由于所依赖元素的状态而无法正常运行。 例如，网络服务或终结点因低层网络问题而无法正常运行。
已完成
17
 指示作业已完成其操作。 该值应与正常、错误或已降级结合使用，以便客户端可以判断完整操作是 Completed with OK（已通过）、Completed with Error（已失败）还是 Completed with Degraded（操作已完成，但并没有正常完成，或者未报告错误）。
Power Mode
18
 “电源模式”指示该元素具有包含在 AssociatedPowerManagementService 关联中的附加电源模型信息。
DMTF 保留
19 32767
 DMTF 保留了范围中的该部分，供以后其他 OperationalStatus 值之用。
供应商保留
32768 65535
 Microsoft 保留了范围中未用的部分，供以后其他 OperationalStatus 值之用。

PrimaryStatus

数据类型：uint16

访问类型：只读

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

指示高级状态值。

此属性继承自 CIM_ManagedSystemElement。

可能的值为 。

未知 (0)

正常 (1)

已降级 (2)

错误 (3)

DMTF 保留 (4 32767)

供应商保留（32768 = 值）

Status

数据类型：string

访问类型：只读

限定符：Deprecated ("CIM_ManagedSystemElement.OperationalStatus")、MaxLen (10)

包含一个字符串，指示对象的主要状态。

注意

此属性已弃用，并替换为 OperationalStatus 属性。 如果选择使用 Status 属性来实现后向兼容性，则该属性应是 OperationalStatus 属性的辅助属性。

此属性继承自 CIM_ManagedSystemElement。

可能的值为 。

（“正常”）

（“错误”）

（“已降级”）

（“未知”）

("Pred Fail")

("Starting")

("Stopping")

("Service")

("Stressed")

("NonRecover")

("No Contact")

("Lost Comm")

("Stopped")

StatusDescriptions

数据类型：字符串数组

访问类型：只读

限定符：ArrayType ("Indexed")、ModelCorrespondence ("CIM_ManagedSystemElement.OperationalStatus")

指示 OperationalStatus 数组中相应值的说明。 例如，如果 OperationalStatus 属性中的元素包含值 Stopping，则此属性中同一数组索引处的元素可能包含有关对象被停止的原因的说明。

此属性继承自 CIM_ManagedSystemElement。

要求
最低受支持的客户端
 Windows 8
最低受支持的服务器
 Windows Server 2012
命名空间
 Root\standardcimv2
MOF
NetTCPIP.mof
DLL
NetTCPIP.dll

另请参阅

CIM_ManagedSystemElement