Represents an instance of an extension component installed on a host system.
The following syntax is simplified Managed Object Format (MOF) code, and it includes all of the inherited properties.
Syntax
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_InstalledEthernetSwitchExtension : CIM_ManagedSystemElement
{
string InstanceID;
string Caption = " System Virtual Ethernet Switch Extension";
string Description = "Microsoft NDIS Packet Capture Filter Driver";
string ElementName = "Microsoft NDIS Capture";
datetime InstallDate;
string Name;
uint16 OperationalStatus[] = 2;
string StatusDescriptions[] = "OK";
string Status = "OK";
uint16 HealthState = 5;
uint16 CommunicationStatus;
uint16 DetailedStatus;
uint16 OperatingStatus;
uint16 PrimaryStatus;
uint8 ExtensionType;
string Vendor;
string Version;
};
Members
The Msvm_InstalledEthernetSwitchExtension class has these types of members:
Properties
The Msvm_InstalledEthernetSwitchExtension class has these properties.
Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen (64)
A short description of the object. This property is inherited from CIM_ManagedElement.
CommunicationStatus
Data type: uint16
Access type: Read-only
Indicates the ability of the instrumentation to communicate with the underlying managed element. A Null value indicates that this property is not implemented. This property is inherited from CIM_ManagedSystemElement.
Description
Data type: string
Access type: Read-only
A description of the object. This property is inherited from CIM_ManagedElement.
DetailedStatus
Data type: uint16
Access type: Read-only
Complements the PrimaryStatus property with additional status detail. A Null value indicates that this property is not implemented. This property is inherited from CIM_ManagedSystemElement.
ElementName
Data type: string
Access type: Read-only
A display name for the object. This property is inherited from CIM_ManagedElement.
ExtensionType
Data type: uint8
Access type: Read-only
Indicates the type of the extension component.
Unknown (0)
Capture (1)
Filter (2)
Forwarding (3)
Monitoring (4)
Native (5)
HealthState
Data type: uint16
Access type: Read-only
The current health of the element. This attribute expresses the health of this element but not necessarily that of its subcomponents. The possible values are 0 to 30, where 5 means the element is entirely healthy and 30 means the element is completely nonfunctional. This property is inherited from CIM_ManagedSystemElement, and it is always set to 5 (OK).
InstallDate
Data type: datetime
Access type: Read-only
The date and time when the object was installed. This property does not need a value to indicate that the object is installed. This property is inherited from CIM_ManagedSystemElement.
InstanceID
Data type: string
Access type: Read-only
Qualifiers: Key
Uniquely identifies an instance of this class. This property is inherited from CIM_ManagedElement.
Name
Data type: string
Access type: Read-only
Qualifiers: Key, Override ("Name"), MaxLen (256)
The label by which the object is known. This property is inherited from CIM_ManagedSystemElement.
OperatingStatus
Data type: uint16
Access type: Read-only
Provides current status information for the operational condition of the element and can be used for providing more detail with respect to the value of the EnabledState property. A Null value indicates that this property is not implemented. This property is inherited from CIM_ManagedSystemElement.
OperationalStatus
Data type: uint16 array
Access type: Read-only
The current statuses of the object. This property is inherited from CIM_ManagedSystemElement, and each array element is always set to 2 (OK).
PrimaryStatus
Data type: uint16
Access type: Read-only
Provides high level status information. This property should be used in conjunction with the DetailedStatus property to provide high level and detailed health status information for the element and its subcomponents. A Null value indicates that this property is not implemented. This property is inherited from CIM_ManagedSystemElement.
Status
Data type: string
Access type: Read-only
The current status of the object. This property is inherited from CIM_ManagedSystemElement.
"OK"
OK
Error
Degraded
Unknown
Pred Fail
Starting
Stopping
Service
Stressed
NonRecover
No Contact
Lost Comm
StatusDescriptions
Data type: string array
Access type: Read-only
Strings that describe the various OperationalStatus array values. This property is inherited from CIM_ManagedSystemElement, and each array element is always set to "OK".
Vendor
Data type: string
Access type: Read-only
Indicates the vendor providing the extension.
Version
Data type: string
Access type: Read-only
The version of the extension in a format of "major.minor", for example "2.0".
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 [desktop apps only] |
| Minimum supported server | Windows Server 2012 [desktop apps only] |
| Namespace | Root\Virtualization\V2 |
| MOF | WindowsVirtualization.V2.mof |
| DLL | Vmms.exe |
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
