通过

MSFT_NetEventProviderBase 类

此类在用于事件捕获的计算机上封装 ETW 提供程序。

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

语法

[UMLPackagePath("CIM::Core::CoreElements"), Abstract, ClassVersion("1.0"), AMENDMENT]
class MSFT_NetEventProviderBase : CIM_LogicalElement
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   Name;
  string   Guid;
  string   SessionGuid;
  string   SessionName;
  uint8    Level;
  uint64   MatchAnyKeyword;
  uint64   MatchAllKeyword;
};

成员

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

性能

MSFT_NetEventProviderBase 类具有以下属性。

标题

数据类型：字符串

访问类型：只读

限定符：MaxLen （64）

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

此属性继承自 CIM_ManagedElement。

CommunicationStatus

数据类型：uint16

访问类型：只读

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

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

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

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

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

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

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

此属性继承自 CIM_ManagedSystemElement。

价值 意义
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”表示该元素正常运行，但需要注意。 “压力”状态的示例包括重载、过热等。

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

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

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

此属性继承自 CIM_ManagedSystemElement。

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

ElementName

数据类型：字符串

访问类型：只读

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

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

此属性继承自 CIM_ManagedElement。

Guid

数据类型：字符串

访问类型：只读

限定符：密钥

Guid，计算机上安装的提供程序的唯一 ID。

HealthState

数据类型：uint16

访问类型：只读

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

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

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

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

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

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

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

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

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

此属性继承自 CIM_ManagedSystemElement。

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

InstallDate

数据类型：datetime

访问类型：只读

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

此属性继承自 CIM_ManagedSystemElement。

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。

级别

数据类型：uint8

访问类型：只读

事件捕获的最大事件级别。

MatchAllKeyword

数据类型：uint64

访问类型：只读

为事件捕获指定的 MatchAllKeyword 掩码。

MatchAnyKeyword

数据类型：uint64

访问类型：只读

为事件捕获指定的 MatchAnyKeyword 掩码。

名称

数据类型：字符串

访问类型：只读

限定符：MaxLen （1024）

提供程序的名称

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”描述服务和作中的元素。

此属性继承自 CIM_ManagedSystemElement。

价值 意义
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 的第一个值应包含元素的主要状态。 检测时，状态（因为它是单值）还应提供元素的主要状态。

此属性继承自 CIM_ManagedSystemElement。

价值 意义
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 处于错误状态。

此属性继承自 CIM_ManagedSystemElement。

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

SessionGuid

数据类型：字符串

访问类型：只读

限定符：密钥

当会话的一部分时，Guid 是会话的唯一 ID。 否则为 NULL Guid。

SessionName

数据类型：字符串

访问类型：只读

提供程序的会话，在会话的一部分时。

状态

数据类型：字符串

访问类型：只读

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

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

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

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

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

此属性继承自 CIM_ManagedSystemElement。

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

StatusDescriptions

数据类型：字符串 数组

访问类型：只读

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

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

此属性继承自 CIM_ManagedSystemElement。

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

另请参阅

CIM_LogicalElement