Msvm_SerialPort 类

表示与串行控制器关联的串行端口。

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

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_SerialPort : CIM_LogicalPort
{
  string   InstanceID;
  string   Caption;
  string   Description = "Microsoft Virtual Serial Port";
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "OK" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_SerialPort";
  string   DeviceID;
  boolean  PowerManagementSupported;
  uint16   PowerManagementCapabilities[];
  uint16   Availability = 6;
  uint16   StatusInfo;
  uint32   LastErrorCode;
  string   ErrorDescription;
  boolean  ErrorCleared;
  string   OtherIdentifyingInfo[];
  uint64   PowerOnHours;
  uint64   TotalPowerOnHours;
  string   IdentifyingDescriptions[];
  uint16   AdditionalAvailability[] = { 6 };
  uint64   MaxQuiesceTime;
  uint64   Speed = 115200;
  uint32   MaxSpeed = 115200;
  uint64   RequestedSpeed = 115200;
  uint16   UsageRestriction = 4;
  uint16   PortType = 1;
  string   OtherPortType = "Serial Port";
};

成员

Msvm_SerialPort 类包含以下类型的成员:

方法

Msvm_SerialPort类具有这些方法。

方法 说明
EnableDevice 不支持此方法。
OnlineDevice 不支持此方法。
QuiesceDevice 不支持此方法。
RequestStateChange 请求状态更改。
重置 重置虚拟设备。
RestoreProperties 不支持此方法。
SaveProperties 不支持此方法。
SetPowerState 不支持此方法。

属性

Msvm_SerialPort类具有这些属性。

AdditionalAvailability

数据类型: uint16 数组

访问类型:只读

设备的任何其他可用性和状态。 此属性继承自 CIM_LogicalDevice

含义
{ 6 }
6
不适用

可用性

数据类型: uint16

访问类型:只读

设备的主要可用性和状态。 此属性继承自 CIM_LogicalDevice

含义
6
不适用

AvailableRequestedStates

数据类型: uint16 数组

访问类型:只读

指示 RequestStateChange 方法的 RequestedState 参数的可能值。 此属性继承自 CIM_EnabledLogicalElement,但不使用该属性。

Caption

数据类型: 字符串

访问类型:只读

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

CommunicationStatus

数据类型: uint16

访问类型:只读

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

未知 (0)

不可用 (1)

通信正常 (2)

丢失的通信 (3)

无联系人 (4)

DMTF 保留 (。。)

供应商保留 (0x8000。。)

CreationClassName

数据类型: 字符串

访问类型:只读

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

说明

数据类型: 字符串

访问类型:只读

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

DetailedStatus

数据类型: uint16

访问类型:只读

PrimaryStatus 属性补充其他状态详细信息。 Null 值指示此属性未实现。 此属性继承自 CIM_ManagedSystemElement

不可用 (0)

无其他信息 (1)

压力 (2)

预测故障 (3)

不可恢复的错误 (4)

错误 (5) 支持实体

DMTF 保留 (。。)

供应商保留 (0x8000。。)

DeviceID

数据类型: 字符串

访问类型:只读

此属性继承自 CIM_LogicalDevice,它设置为“Microsoft:GUIDdevice-specific-data\”,其中设备特定数据是可选的。

ElementName

数据类型: 字符串

访问类型:只读

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

EnabledDefault

数据类型: uint16

访问类型:只读

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

含义
2
已启用

EnabledState

数据类型: uint16

访问类型:只读

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

含义
5
不适用

ErrorCleared

数据类型: 布尔值

访问类型:只读

指示是否已清除 LastErrorCode 属性中报告的错误。 此属性继承自 CIM_LogicalDevice,但不使用它。

ErrorDescription

数据类型: 字符串

访问类型:只读

一个字符串,提供有关 LastErrorCode 属性中记录的错误的详细信息以及可能采取的任何纠正措施的信息。 此属性继承自 CIM_LogicalDevice,但不使用它。

HealthState

数据类型: uint16

访问类型:只读

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

IdentifyingDescriptions

数据类型: 字符串 数组

访问类型:只读

一个自由格式字符串数组,提供 OtherIdentifyingInfo 属性数组中条目背后的说明和详细信息。 此属性继承自 CIM_LogicalDevice,并将其设置为 Null

InstallDate

数据类型: datetime

访问类型:只读

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

InstanceID

数据类型: 字符串

访问类型:只读

限定符: 密钥

唯一标识此类的实例。 此属性继承自 CIM_ManagedElement

LastErrorCode

数据类型: uint32

访问类型:只读

逻辑设备报告的最后一个错误代码。 此属性继承自 CIM_LogicalDevice,但不使用它。

MaxQuiesceTime

数据类型: uint64

访问类型:只读

此属性已弃用。 此属性继承自 CIM_LogicalDevice

MaxSpeed

数据类型: uint32

访问类型:只读

端口的最大带宽(以每秒位数为单位)。 此属性继承自 CIM_LogicalPort

名称

数据类型: 字符串

访问类型:只读

对象的已知标签。 此属性继承自 CIM_ManagedSystemElement,它与 ElementName 属性相同。

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

OtherIdentifyingInfo

数据类型: 字符串 数组

访问类型:只读

除了设备 ID 信息之外,任何其他数据都可用于标识逻辑设备。 此属性继承自 CIM_LogicalDevice,并设置为 Null

OtherPortType

数据类型: 字符串

访问类型:只读

PortType 设置为 1 (其他) 时模块的类型。 此属性继承自 CIM_LogicalPort

PortType

数据类型: uint16

访问类型:只读

此属性继承自 CIM_LogicalPort

含义
1
其他

PowerManagementCapabilities

数据类型: uint16 数组

访问类型:只读

设备的电源管理功能。 此属性继承自 CIM_LogicalDevice,但未使用。

PowerManagementSupported

数据类型: 布尔值

访问类型:只读

指示设备是否可以进行电源管理。 此属性继承自 CIM_LogicalDevice,但未使用。

PowerOnHours

数据类型: uint64

访问类型:只读

自上次电源周期以来,此设备已打开的连续小时数。 此属性继承自 CIM_LogicalDevice,但未使用。

PrimaryStatus

数据类型: uint16

访问类型:只读

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

未知 (0)

正常 (1)

降级 (2)

错误 ( 3)

DMTF 保留 (。。)

供应商保留 (0x8000.。)

RequestedSpeed

数据类型: uint64

访问类型:只读

请求的端口带宽(以每秒比特为单位)。 此属性继承自 CIM_LogicalPort

RequestedState

数据类型: uint16

访问类型:只读

元素的最后一个请求或所需状态。 元素的实际状态由 EnabledState 表示。 此属性用于比较上次请求的状态和当前启用状态或禁用状态。 此属性继承自 CIM_EnabledLogicalElement

含义
12
不适用

速度

数据类型: uint64

访问类型:只读

端口的带宽(以每秒位为单位)。 此属性继承自 CIM_LogicalPort

Status

数据类型: 字符串

访问类型:只读

对象的当前状态。 此属性继承自 CIM_ManagedSystemElement,但不使用该属性。

StatusDescriptions

数据类型: 字符串 数组

访问类型:只读

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

StatusInfo

数据类型: uint16

访问类型:只读

逻辑设备的当前状态。 此属性继承自 CIM_LogicalDevice,但未使用。

SystemCreationClassName

数据类型: 字符串

访问类型:只读

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

SystemName

数据类型: 字符串

访问类型:只读

范围虚拟机的唯一标识符。 此属性继承自 CIM_LogicalDevice

TimeOfLastStateChange

数据类型: datetime

访问类型:只读

上次更改元素的启用状态的日期或时间。 此属性继承自 CIM_EnabledLogicalElement,并且始终设置为 Null

TotalPowerOnHours

数据类型: uint64

访问类型:只读

此设备已供电的总小时数。 此属性继承自 CIM_LogicalDevice,但未使用。

TransitioningToState

数据类型: uint16

访问类型:只读

指示实例正在转换的目标状态。 此属性继承自 CIM_EnabledLogicalElement,但不使用该属性。

UsageRestriction

数据类型: uint16

访问类型:只读

在某些情况下,逻辑端口可能标识为前端或后端端口。 这种情况的一个示例是一个存储阵列,该阵列可能具有后端端口来与磁盘驱动器和前端端口通信以与主机通信。 如果对端口的使用没有限制,则应将该值设置为 4 (“不受限制”) 。 此属性继承自 CIM_LogicalPort

含义
4
不受限制

注解

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

要求

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

另请参阅

CIM_LogicalPort

CIM_LogicalPort

串行设备类