Msvm_VirtualEthernetSwitch 类

项目
06/12/2023

表示虚拟以太网交换机。每个交换机都有许多不同的端口，网络适配器可以连接到这些端口。开关本身不是高度可配置的，主要充当占位符。

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

语法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualEthernetSwitch : CIM_ComputerSystem
{
  string   InstanceID;
  string   Caption = "Virtual Switch";
  string   Description = "Microsoft Virtual Switch";
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 5;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   CreationClassName = "Msvm_VirtualEthernetSwitch";
  string   Name = "GUID";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   Roles[];
  string   NameFormat;
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   Dedicated[];
  string   OtherDedicatedDescriptions[];
  uint16   ResetCapability = 5;
  uint16   PowerManagementCapabilities[];
  uint32   MaxVMQOffloads;
  uint32   MaxIOVOffloads;
};

成员

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

方法
属性

方法

Msvm_VirtualEthernetSwitch 类具有这些方法。

方法	说明
RequestStateChange	请求状态更改。
SetPowerState	不支持此方法。

属性

Msvm_VirtualEthernetSwitch 类具有这些属性。

AvailableRequestedStates

数据类型： uint16 数组
访问类型：只读

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

此属性继承自 CIM_EnabledLogicalElement。

已启用 (2)
已禁用 (3)
关闭 (4)
脱机 (6)
测试 (7)
延迟 (8)
静止 (9)
重新启动 (10)
重置 (11)
DMTF 保留 (。)

Caption

数据类型： string
访问类型：只读

对象的简短说明。此属性继承自 CIM_ManagedElement，并且始终设置为“虚拟交换机”。

CommunicationStatus

数据类型： uint16
访问类型：只读

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

未知 (0)
不可用 (1)
通信正常 (2)
丢失通信 (3)
No Contact (4)
DMTF 保留 (。)
供应商预留 (0x8000。)

CreationClassName

数据类型： string
访问类型：只读

用于创建实例的类或子类的名称。此属性继承自 CIM_System，始终设置为“Msvm_VirtualEthernetSwitch”。

专用

数据类型： uint16 数组
访问类型：只读

指示计算机系统是专用系统 (专用于特定用途) ，还是常规用途系统。此属性继承自 CIM_ComputerSystem，并且始终设置为 0 (非专用) 。

描述

数据类型： string
访问类型：只读

对象的说明。此属性继承自 CIM_ManagedElement，并且始终设置为“Microsoft 虚拟交换机”。

DetailedStatus

数据类型： uint16
访问类型：只读

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

不可用 (0)
无其他信息 (1)
压力 (2)
预测故障 (3)
不可恢复的错误 (4)
支持错误 5 (中的实体)
DMTF 保留 (。)
供应商预留 (0x8000。)

ElementName

数据类型： string
访问类型：只读

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

EnabledDefault

数据类型： uint16
访问类型：只读

元素的启用状态的管理员默认或启动配置。此属性继承自 CIM_EnabledLogicalElement ，将是以下值之一。

已启用 (2)
已禁用 (3)
已启用但脱机 (6)

EnabledState

数据类型： uint16
访问类型：只读

元素的启用和禁用状态。此属性还可以指示这些请求状态之间的转换。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 5 (不适用) 。

HealthState

数据类型： uint16
访问类型：只读

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

发生严重错误时，检查事件日志了解详细信息。 EnabledState 属性还可以包含详细信息。例如，当磁盘空间严重不足时， HealthState 设置为 25，虚拟机暂停， EnabledState 设置为 32768 (暂停) 。

此属性继承自 CIM_ManagedSystemElement。

值	含义
确定 5	元素功能齐全，在正常操作参数中运行且没有错误。
主要故障 20	该元素遭受了重大失败。
严重故障 25	元素不可正常工作，可能无法恢复。

IdentifyingDescriptions

数据类型： 字符串 数组
访问类型：只读

此属性继承自 CIM_ComputerSystem，并且始终设置为 Null。

InstallDate

数据类型： datetime
访问类型：只读

为虚拟机创建虚拟机配置的日期和时间，或者为管理操作系统创建 Null。此属性继承自 CIM_ManagedSystemElement。

InstanceID

数据类型： string
访问类型：只读
限定符：键

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

MaxIOVOffloads

数据类型： uint32
访问类型：只读

此交换机上可用的单根 IO 虚拟化 (SR-IOV) 虚拟函数卸载的最大数目。

MaxVMQOffloads

数据类型： uint32
访问类型：读/写

此交换机上允许的端口 (VMQ) 卸载的最大虚拟机队列数。

名称

数据类型： string
访问类型：只读

对象的已知标签。此属性继承自 CIM_System，并且始终设置为“GUID”。

NameFormat

数据类型： string
访问类型：只读

一个字符串，标识系统名称的生成方式，使用子类启发法。此属性继承自 CIM_ComputerSystem，并且始终设置为 Null。

OperatingStatus

数据类型： uint16
访问类型：只读

提供元素操作条件的当前状态信息，并可用于提供有关 EnabledState 属性值的更多详细信息。 Null 值指示未实现此属性。此属性继承自 CIM_ManagedSystemElement。

未知 (0)
不可用 (1)
服务 (2)
开始 (3)
停止 (4)
已停止 (5)
中止 (6)
休眠 (7)
已完成 (8)
迁移 (9)
移民 (10)
移民 (11)
快照 (12)
正在关闭 (13)
在测试 (14)
转换 (15)
在 Service (16)
DMTF 保留 (。)
供应商预留 (0x8000。)

OperationalStatus

数据类型： uint16 数组
访问类型：只读

包含对象的当前状态的数组。此属性继承自 CIM_ManagedSystemElement。

OtherDedicatedDescriptions

数据类型： 字符串 数组
访问类型：只读

一个字符串，描述当专用数组包含值 2 (Other) 时系统如何或为什么专用。此属性继承自 CIM_ComputerSystem，并且始终设置为 Null。

OtherEnabledState

数据类型： string
访问类型：只读

EnabledState 属性设置为 1 时元素的启用或禁用状态， (Other) 。当 EnabledState 为除 1 以外的任何值时，此属性必须设置为 Null。此属性继承自 CIM_EnabledLogicalElement，并且始终设置为 Null。

OtherIdentifyingInfo

数据类型： 字符串 数组
访问类型：只读

此属性继承自 CIM_ComputerSystem，并且始终设置为 Null。

PowerManagementCapabilities

数据类型： uint16 数组
访问类型：只读

此属性继承自 CIM_ComputerSystem，但不使用它。

PrimaryOwnerContact

数据类型： string
访问类型：只读

一个字符串，指示如何联系主系统所有者 (例如电话号码或电子邮件地址) 。此属性继承自 CIM_System，并且始终设置为 Null。

PrimaryOwnerName

数据类型： string
访问类型：只读

主系统所有者的名称。此属性继承自 CIM_System，并且始终设置为 Null。

PrimaryStatus

数据类型： uint16
访问类型：只读

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

未知 (0)
确定 (1)
降级 (2)
错误 (3)
DMTF 保留 (。)
供应商预留 (0x8000。)

RequestedState

数据类型： uint16
访问类型：只读

传递给 RequestStateChange 方法的元素的最后请求或所需状态;如果未进行状态更改，则为 12 (不适用) 。元素的实际状态由 EnabledState 表示。提供此属性用于比较上次请求的状态和当前的启用或禁用状态。此属性继承自 CIM_EnabledLogicalElement。

ResetCapability

数据类型： uint16
访问类型：只读

此属性继承自 CIM_ComputerSystem，并且始终设置为 5 () 未实现。

角色

数据类型： 字符串 数组
访问类型：只读

描述系统在信息技术环境中所扮演的角色的字符串数组。此属性继承自 CIM_System，并且始终设置为 Null。

Status

数据类型： string
访问类型：只读

一个指定元素状态的字符串。此属性继承自 CIM_ManagedSystemElement。

StatusDescriptions

数据类型： 字符串 数组
访问类型：只读
限定符： ArrayType (“Indexed”)

一个数组，其中包含描述相应 OperationalStatus 数组值的字符串。此属性继承自 CIM_ManagedSystemElement。

TimeOfLastStateChange

数据类型： datetime
访问类型：只读

元素的启用状态上次更改的日期和时间。此属性继承自 CIM_EnabledLogicalElement。

TransitioningToState

数据类型： uint16
访问类型：只读

指示实例要转换到的目标状态。此属性继承自 CIM_EnabledLogicalElement。

要求

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

Msvm_VirtualEthernetSwitch 类

语法

成员

方法

属性

要求

反馈

反馈

其他资源