CIM_LogicalPort 类

  • 项目

设备的端口或连接点的抽象。 当端口具有独立于包含它的设备的管理特性时，应实例化该对象。 例如光纤通道端口和 USB 端口。

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

语法

[UMLPackagePath("CIM::Device::Ports"), Version("2.10.0"), AMENDMENT]
class CIM_LogicalPort : CIM_LogicalDevice
{
  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;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   TransitioningToState = 12;
  uint16   AvailableRequestedStates[];
  string   SystemCreationClassName;
  string   SystemName;
  string   CreationClassName;
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[];
  uint64   MaxQuiesceTime;
  uint64   Speed;
  uint64   MaxSpeed;
  uint64   RequestedSpeed;
  uint16   UsageRestriction;
  uint16   PortType;
  string   OtherPortType;
};

成员

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

方法

CIM_LogicalPort 类采用以下方法。

方法 说明
EnableDevice 此方法已被弃用，取而代之的是与此方法提供的功能直接重叠的更通用的 RequestStateChange 方法。
此方法继承自 CIM_LogicalDevice。
OnlineDevice 此方法已被弃用，取而代之的是与此方法提供的功能直接重叠的更通用的 RequestStateChange 方法。
此方法继承自 CIM_LogicalDevice。
QuiesceDevice 此方法已被弃用，取而代之的是与此方法提供的功能直接重叠的更通用的 RequestStateChange 方法。
此方法继承自 CIM_LogicalDevice。
RequestStateChange 请求将元素的状态更改为 RequestedState 参数中指定的值。 当请求的状态更改发生时，元素的启用状态的和请求状态将是相同的。 多次调用 RequestChangeState 方法可能会导致早期请求被覆盖或丢失。 如果返回 0，则任务已成功完成，并且不需要使用 CIM_ConcreteJob。 如果返回 4096 (0x1000)，则表明任务需要一些时间才能完成，此时将创建 CIM_ConcreteJob，并在输出参数 Job 中返回其引用。 任何其他返回代码均指示错误条件。
此方法继承自 CIM_EnabledLogicalElement。
重置 请求重置逻辑设备。
此方法继承自 CIM_LogicalDevice。
RestoreProperties 请求设备从后备存储重新建立其配置、安装和/或状态信息。
此方法继承自 CIM_LogicalDevice。
SaveProperties 请求设备在后备存储中捕获其当前配置、安装和/或状态信息。
此方法继承自 CIM_LogicalDevice。
SetPowerState 设置设备的电源状态。 此方法已被否决。 请改用关联的 PowerManagementService 类中的 SetPowerState 方法。
此方法继承自 CIM_LogicalDevice。

属性

CIM_LogicalPort 类具有以下属性。

AdditionalAvailability

数据类型：uint16 数组

访问类型：只读

限定符：ModelCorrespondence（“CIM_LogicalDevice.Availability”）

超出 Availability 属性中指定的设备的其他可用性和状态。 Availability 属性表示设备的主要状态和可用性。 在某些情况下，这不足以表示设备的完整状态。 在这些情况下，AdditionalAvailability 属性可用于提供进一步的信息。 例如，设备的主要可用性可能为“脱机”（值=8），但它也可能处于低功耗状态（AdditonalAvailability 值=14），或者设备可能正在运行诊断（AdditionalAvailability 值=5，“测试中”）。

此属性继承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

正在运行/全功率 (3)

警告 (4)

测试中 (5)

不可用 (6)

关机 (7)

下线 (8)

下班 (9)

已降级 (10)

未安装 (11)

安装错误 (12)

省电 - 未知 (13)

省电 - 低功率模式 (14)

省电 - 待机 (15)

电源周期 (16)

省电 - 警告 (17)

已暂停 (18)

未就绪 (19)

未配置 (20)

静止 (21)

可用性

数据类型：uint16

访问类型：只读

限定符：ModelCorrespondence（“CIM_LogicalDevice.AdditionalAvailability”）

设备的主要可用性和状态。 （可以使用其他可用性数组属性指定其他状态信息。）

此属性继承自 CIM_LogicalDevice。

值 含义
其他
1
Unknown
2
正在运行/全功率
3
警告
4
测试中
5
不适用
6
关闭电源
7
脱机
8
中断
9
已降级
10
未安装
11
安装错误
12
省电 - 未知
13
 已知设备处于省电模式，但设备在此模式下的确切状态是未知的
省电 - 低功率模式
14
 设备处于省电状态，但仍正常运行，并可能表现出性能下降
省电 - 待机
15
 设备不在正常运行，但可以快速进入全功率。
电源周期
16
省电 - 警告
17
 设备处于警告状态，但也处于省电模式。
已暂停
18
未就绪
19
未配置
20
静止
21

AvailableRequestedStates

数据类型：uint16 数组

访问类型：只读

限定符：ModelCorrespondence（“CIM_EnabledLogicalElement.RequestStateChange”、“CIM_EnabledLogicalElementCapabilities.RequestedStatesSupported”）

AvailableRequestedStates 指示用于启动状态更改的方法 Requeststate 的 RequestedState 参数的可能值。 列出的值将是 CIM_EnabledLogicalElementCapabilities 关联实例的 RequestedStatesSupported 属性中所包含值的子集，其中所选值是 CIM_EnabledLogicalElement 的当前状态的函数。 如果实现能够播发可能的值集作为当前状态的函数，则此属性可能为非 null。 如果实现无法确定作为当前状态函数的可能值集，则此属性将为 null。

此属性继承自 CIM_EnabledLogicalElement。

启用 (2)

已禁用 (3)

关闭 (4)

脱机 (6)

测试 (7)

延迟 (8)

静止 (9)

重新启动 (10)

重置 (11)

DMTF 保留 (12 65535)

Caption

数据类型：字符串

访问类型：只读

限定符：MaxLen (64)

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

此属性继承自 CIM_ManagedElement。

CommunicationStatus

数据类型：uint16

访问类型：只读

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

此属性继承自 CIM_ManagedSystemElement。

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

CreationClassName

数据类型： 字符串

访问类型：只读

限定符：key、MaxLen (256)

指示在创建实例时使用的类或子类的名称。 与此类的其他关键属性一起使用时，此属性允许唯一标识此类及其子类的所有实例。

此属性继承自 CIM_LogicalDevice。

描述

数据类型：字符串

访问类型：只读

提供对象的文本描述。

此属性继承自 CIM_ManagedElement。

DetailedStatus

数据类型：uint16

访问类型：只读

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

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

此属性继承自 CIM_ManagedSystemElement。

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

DeviceID

数据类型：字符串

访问类型：只读

限定符：key、MaxLen (64)

用于为逻辑设备指定唯一名称的地址或其他标识信息

此属性继承自 CIM_LogicalDevice。

ElementName

数据类型： 字符串

访问类型：只读

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

此属性继承自 CIM_ManagedElement。

EnabledDefault

数据类型：uint16

访问类型：读/写

一个枚举值，指示元素的启用状态的管理员默认或启动配置。 默认情况下，元素为“Enabled”(value=2)。

此属性继承自 CIM_EnabledLogicalElement。

启用 (2)

已禁用 (3)

不可用 (5)

已启用但脱机 (6)

无默认值 (7)

静止 (9)

DMTF 保留 (10 32767)

供应商预留 (32768 65535)

EnabledState

数据类型：uint16

访问类型：只读

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

指示元素的启用和禁用状态。 还可以指示这些请求的状态之间的过渡值。 例如，正在关闭（值=4）和正在启动（值=10）是启用和禁用之间的瞬时状态。

此属性继承自 CIM_EnabledLogicalElement。

值 含义
未知
0
其他
1
Enabled
2
 元素正在或可能正在执行命令，将处理队列中的任何命令并将新请求加入队列。
已禁用
3
 元素不会执行命令，并将丢弃所有新请求。
正在关闭
4
 元素正在进入“已禁用”状态。
不适用
5
 元素不支持“已启用”或“已禁用”状态。
已启用但脱机
6
 元素可能正在完成命令，它将删除任何新请求。
测试中
7
 元素处于测试状态。
已推迟
8
 元素可能正在完成命令，但它会将任何新请求排入队列。
Quiesce
9
 该元素已启用，但处于受限模式。 该元素的行为类似于“已启用”状态 (2)，但它只处理一组受限的命令。 所有其他请求都已排队。
正在启动
10
 元素正在进入“已启用”状态 (2)。 新请求已排队。
DMTF 保留
11 32767
 保留。
供应商保留
32768 65535
 保留。

ErrorCleared

数据类型： 布尔值

访问类型：只读

限定符：Deprecated（“CIM_ManagedSystemElement.OperationalStatus”）

布尔属性，指示现已清除 LastErrorCode 中报告的错误。

此属性继承自 CIM_LogicalDevice。

ErrorDescription

数据类型：字符串

访问类型：只读

限定符：Deprecated（“CIM_DeviceErrorData.ErrorDescription”）

自由格式字符串，提供有关 LastErrorCode 中记录的错误的更多信息，以及有关可能采取的任何纠正措施的信息。

此属性继承自 CIM_LogicalDevice。

HealthState

数据类型：uint16

访问类型：只读

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

此属性继承自 CIM_ManagedSystemElement。

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

IdentifyingDescriptions

数据类型：字符串数组

访问类型：只读

限定符：ArrayType（“Indexed”）、ModelCorrespondence（“CIM_LogicalDevice.OtherIdentifyingInfo”）

自由格式的字符串数组，提供 OtherIdentifyingInfo 数组中的条目背后的说明和详细信息。 请注意，此数组的每个条目都与位于同一索引的 OtherIdentifyingInfo 中的条目相关。

此属性继承自 CIM_LogicalDevice。

InstallDate

数据类型：datetime

访问类型：只读

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

此属性继承自 CIM_ManagedSystemElement。

InstanceID

数据类型：字符串

访问类型：只读

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

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

OrgID：LocalID

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

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

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

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

此属性继承自 CIM_ManagedElement。

LastErrorCode

数据类型：uint32

访问类型：只读

限定符：Deprecated（“CIM_DeviceErrorData.LastErrorCode”）

捕获逻辑设备报告的最后一个错误代码。

此属性继承自 CIM_LogicalDevice。

MaxQuiesceTime

数据类型：uint64

访问类型：只读

限定符：Deprecated（“No value”）、Units（“MilliSeconds”）

此属性已弃用。 评估 Quiesce 的使用时，确定此单个属性不足以描述设备何时自动退出静止状态。 事实上，设备退出静止状态的最有可能的方案是根据加入队列的未完成请求数而不是最长时间确定的。 稍后将重新评估和重新定位。

设备可以在“已静止”状态下运行的最长时间（以毫秒为单位）。 设备的状态在其 Availability 和 AdditionalAvailability 属性中定义，值 21 表示“已静止”。 时间限制结束时发生的情况是设备特定的。 设备可能取消静止，可能脱机或采取其他操作。 值为 0 时，指示设备可以无限期静止。

此属性继承自 CIM_LogicalDevice。

MaxSpeed

数据类型：uint64

访问类型：只读

限定符：PUnit（“位/秒”）、Units（“每秒位数”）

端口的最大带宽（以位每秒为单位）。

Name

数据类型：字符串

访问类型：只读

限定符：MaxLen (1024)

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

[提示！]
名称在命名空间中不必是唯一的。

此属性继承自 CIM_ManagedSystemElement。

OperatingStatus

数据类型：uint16

访问类型：只读

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

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

此属性继承自 CIM_ManagedSystemElement。

值 含义
未知
0
 指示检测目前无法报告 OperatingStatus 属性。
不可用
1
 指示检测能够报告此属性，但故意不报告该元素的此属性。
服务
2
 指示正在对元素进行配置、维护、清理或其他管理操作。
正在启动
3
 指示正在初始化元素。
正在停止
4
 指示正在将元素引入有序停止。
已停止
5
 指示该元素是有意停止的。
已中止
6
 指示该元素是以意外方式停止的。
Dormant
7
 指示该元素处于非活动状态或静止状态。
已完成
8
 指示该元素已完成其操作。 建议使用 PrimaryStatus 的属性值 OK,、Error 或 Degraded 来指示操作是成功还是失败。
迁移
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
 指示已知作业存在并且过去已成功进行联系，但当前无法进行访问。
Aborted
14
 指示作业以意外方式停止。 可能需要更新作业的状态和配置。
Dormant
15
 指示作业处于非活动状态。
支持实体出错
16
 指示此作业所依赖的元素出错。 此元素可能正常，但由于所依赖元素的状态而无法正常运行。 例如，网络服务或终结点因低层网络问题而无法正常运行。
已完成
17
 指示作业已完成其操作。 该值应与 OK、Error 或 Degraded 结合使用，以便客户端可以判断完整操作是 Completed with OK（已通过）、Completed with Error（已失败）还是 Completed with Degraded（操作已完成，但并没有正常完成，或者未报告错误）。
电源模式
18
 “电源模式”指示该元素具有包含在 AssociatedPowerManagementService 关联中的附加电源模型信息。
DMTF 保留
19 32767
 DMTF 保留了范围中的该部分，供以后其他 OperationalStatus 值之用。
供应商保留
32768 65535
 Microsoft 保留了范围中未用的部分，供以后其他 OperationalStatus 值之用。

OtherEnabledState

数据类型： 字符串

访问类型：只读

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

描述当 EnabledState 属性设置为 1（“其他”）时元素的启用或禁用状态的字符串。 当 EnabledState 属性为 1 以外的任何值时，必须将该属性设置为 Null。

此属性继承自 CIM_EnabledLogicalElement。

OtherIdentifyingInfo

数据类型：字符串数组

访问类型：只读

限定符：ArrayType（“Indexed”）、MaxLen (256),、ModelCorrespondence（“CIM_LogicalDevice.IdentifyingDescriptions”）

捕获除了设备 ID 信息之外可用于识别逻辑设备的其他数据。 一个示例是在此属性中保存设备的操作系统用户友好名称。

此属性继承自 CIM_LogicalDevice。

OtherPortType

数据类型： 字符串

访问类型：只读

限定符：ModelCorrespondence（“CIM_LogicalPort.PortType”）

描述当 PortType 设置为 1（“其他”）时的模块类型。

PortType

数据类型：uint16

访问类型：只读

限定符：ModelCorrespondence（“CIM_NetworkPort.OtherNetworkPortType”）

定义为强制在子类中对 Type 属性进行一致的命名，保证 NetworkPort 的所有实例的唯一枚举值。 设置为 1（“其他”）时，相关的 OtherPortType 属性包含端口类型的字符串说明。 定义了系列值 DMTF_Reserved，允许子类重写和定义特定类型的端口。

未知 (0)

其他 (1)

不适用 (2)

DMTF 保留 (3 15999)

供应商预留 (16000.65535)

PowerManagementCapabilities

数据类型：uint16 数组

访问类型：只读

限定符：Deprecated（“CIM_PowerManagementCapabilities.PowerCapabilities”）

描述设备的电源管理功能的枚举数组。 此属性已弃用。 应改为使用关联的 PowerManagementCapabilities 类中的 PowerCapabilites 属性。

此属性继承自 CIM_LogicalDevice。

未知 (0)

不支持 (1)

已禁用 (2)

已启用 (3)

已自动进入省电模式 (4)

电源状态可设置 (5)

支持电源循环 (6)

支持定时开机 (7)

PowerManagementSupported

数据类型：boolean

访问类型：只读

限定符：Deprecated（“CIM_PowerManagementCapabilities”）

指示可以对设备进行电源管理的布尔值。 此属性已弃用。 相反，存在关联的 PowerManagementCapabilities 类（使用 ElementCapabilities 关系关联）表示支持电源管理。

此属性继承自 CIM_LogicalDevice。

PowerOnHours

数据类型：uint64

访问类型：只读

限定符：Counter、Units（“小时”）

此设备自上次通电循环以来连续通电的小时数。

此属性继承自 CIM_LogicalDevice。

PrimaryStatus

数据类型：uint16

访问类型：只读

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

指示高级状态值。

此属性继承自 CIM_ManagedSystemElement。

可能的值为 。

未知 (0)

正常 (1)

已降级 (2)

错误 (3)

DMTF 保留 (4 32767)

供应商预留（32768 = 值）

RequestedSpeed

数据类型：uint64

访问类型：读/写

限定符：ModelCorrespondence（“CIM_LogicalPort.Speed”）、PUnit(“位/秒”）、Units（“每秒位数”）

端口的请求带宽（以位每秒为单位）。 实际带宽在 LogicalPort.Speed 中报告。

RequestedState

数据类型：uint16

访问类型：只读

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

RequestedState 是一个整数枚举，用于指示元素上次请求的状态或所需的状态。 元素的实际状态通过 EnabledState 表示。 提供此属性是为了比较上次请求的状态和当前启用或禁用的状态。 请注意，当 EnabledState 设置为 5（“不适用”）时，此属性没有意义。 默认情况下，元素的 RequestedState 设置为 5（“无更改”）。 有关 RequestedState 枚举中值的说明，请参阅 EnabledState 属性说明。 应注意，RequestedState 中有两个新值根据 EnabledState 的状态生成。 这些值是“重新启动”(10) 和“重置”(11)。 重新启动是指执行“关闭”，然后移动到“已启用”状态。 重置指示元素先是“已禁用”状态，然后是“已启用”状态。 还应注意请求“关闭”和“已禁用”之间的区别。 关闭请求有序地转换为“已禁用”状态，并且可能需要拔除电源，以完全擦除任何现有状态。 “已禁用”状态请求立即禁用该元素，以便它不会执行或接受任何命令或处理请求。 此属性设置为方法调用的结果（如 CIM_Service 上的 StartService 或 StopService），也可以在子类中重写该属性并将其定义为 WRITEable。 该方法被认为优于 WRITEable 属性，因为它允许执行操作的显式调用并返回结果代码。 CIM_EnabledLogicalElement 的特定实例可能不支持 RequestStateChange。 如果发生这种情况，则使用值 12（“不适用”）。

此属性继承自 CIM_EnabledLogicalElement。

未知 (0)

启用 (2)

已禁用 (3)

关闭 (4)

无更改 (5)

脱机 (6)

测试 (7)

延期 (8)

静止 (9)

重新启动 (10)

重置 (11)

不适用 (12)

DMTF 保留 (13 32767)

供应商预留 (32768 65535)

速度

数据类型：uint64

访问类型：只读

限定符：PUnit（“位/秒”）、Units（“每秒位数”）

端口的带宽（以位每秒为单位）。

Status

数据类型：字符串

访问类型：只读

限定符：Deprecated（“CIM_ManagedSystemElement.OperationalStatus”）、MaxLen (10)

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

注意

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

此属性继承自 CIM_ManagedSystemElement。

可能的值为 。

（“正常”）

（“错误”）

（“已降级”）

("Unknown")

("Pred Fail")

("Starting")

("Stopping")

("Service")

("Stressed")

("NonRecover")

("No Contact")

("Lost Comm")

("Stopped")

StatusDescriptions

数据类型：字符串数组

访问类型：只读

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

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

此属性继承自 CIM_ManagedSystemElement。

StatusInfo

数据类型：uint16

访问类型：只读

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

指示逻辑设备是否处于已启用（值 = 3）状态、已禁用（值 = 4）状态或某些其他 (1) 或未知 (2) 状态。 如果此属性不适用于逻辑设备，则应使用值 5（“不适用”）。 StatusInfo 已被弃用，取而代之的是具有附加枚举值 (EnabledState) 的更清晰命名的属性，该属性继承自 CIM_ManagedSystemElement。

此属性继承自 CIM_LogicalDevice。

其他 (1)

未知 (2)

已启用 (3)

已禁用 (4)

不适用 (5)

SystemCreationClassName

数据类型： 字符串

访问类型：只读

限定符：key、MaxLen (256)、Propagated（“CIM_System.CreationClassName”）

作用域系统的 CreationClassName。

此属性继承自 CIM_LogicalDevice。

SystemName

数据类型： 字符串

访问类型：只读

限定符：key、MaxLen (256)、Propagated（“CIM_System.Name”）

作用域系统的名称。

此属性继承自 CIM_LogicalDevice。

TimeOfLastStateChange

数据类型：datetime

访问类型：只读

上次更改元素的“已启用”状态的日期或时间。 如果元素的状态未更改并且已填充此属性，则必须将其设置为 0 间隔值。 如果请求了状态更改，但状态更改已被拒绝或尚未处理，则属性不得更新。

此属性继承自 CIM_EnabledLogicalElement。

TotalPowerOnHours

数据类型：uint64

访问类型：只读

限定符：Counter、Units（“小时”）

此设备已通电的总小时数。

此属性继承自 CIM_LogicalDevice。

TransitioningToState

数据类型：uint16

访问类型：只读

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

TransitioningToState 指示实例正在转换到的目标状态。

值为 5“无更改”应指示未进行转换。值为 12“不适用”应指示实现不支持表示正在进行的转换。

5 或 12 以外的值应标识元素正在转换时的状态。

此属性继承自 CIM_EnabledLogicalElement。

未知 (0)

启用 (2)

已禁用 (3)

关闭 (4)

无更改 (5)

脱机 (6)

测试 (7)

延迟 (8)

静止 (9)

重新启动 (10)

重置 (11)

不适用 (12)

DMTF 保留 (13 65535)

UsageRestriction

数据类型：uint16

访问类型：只读

在某些情况下，可能会将逻辑端口识别为前端或后端端口。 这种情况的示例是存储数组，它可能具有与磁盘驱动器通信的后端端口和与主机通信的前端端口。 如果端口的使用没有限制，则应将该值设置为“不受限制”。

未知 (0)

仅限前端 (2)

仅限后端 (3)

不受限制 (4)

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

另请参阅

CIM_LogicalDevice