Msvm_NetworkElementSettingData class

An association that connects a computer system to a LAN endpoint inside of Hyper-V. This object facilitates finding all of the LAN endpoints for a given computer system without having to know the Ethernet ports.

The following syntax is simplified Managed Object Format (MOF) code, and it includes all of the inherited properties.

Syntax

[Association, Aggregation, Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_NetworkElementSettingData : CIM_ElementSettingData
{
  uint16                           IsDefault;
  uint16                           IsNext;
  uint16                           IsMaximum = 0;
  uint16                           IsMinimum = 0;
  Msvm_VLANEndpointSettingData REF SettingData;
  Msvm_VLANEndpoint            REF ManagedElement;
  uint16                           IsCurrent;
};

Members

The Msvm_NetworkElementSettingData class has these types of members:

Properties

The Msvm_NetworkElementSettingData class has these properties.

IsCurrent

Data type: uint16

Access type: Read-only

Indicates whether the referenced setting is currently being used in the operation of the element or that this information is unknown. For a given managed element and all instances of a setting data subclass, there shall be at most one instance of ElementSettingData which references the managed element and an instance of the setting data subclass where there is a specified non-null, non-key property of the setting data subclass, and the IsMaximum property on the referencing element setting data instance has a value of "Is Maximum" or the IsMinimum property on the referencing element setting data instance has a value of "Is Minimum" and the IsCurrent property on the referencing element setting data instance has a value of "Is Current". There shall be at most one instance of element setting data which references a managed element and an instance of a setting data subclass where the IsCurrent property has a value of "Is Current" and the IsMinimum property does not have a value of "Is Minimum" and the IsMaximum property does not have a value of "Is Maximum". This property is inherited from CIM_ElementSettingData.

Unknown (0)

Is Current (1)

Is Not Current (2)

IsDefault

Data type: uint16

Access type: Read-only

Indicates whether the referenced setting is a default setting for the element or that this information is unknown. This property is inherited from CIM_ElementSettingData.

Unknown (0)

Is Default (1)

Is Not Default (2)

IsMaximum

Data type: uint16

Access type: Read-only

Qualifiers: Experimental

This property affects the interpretation of all non-null, non-enumerated, non-binary, numeric, non-key properties of the associated setting data instance. All other properties of the associated setting data instance are not affected by this property. Note: It is assumed that the semantics of each property of this set are designed to be compared mathematically. When IsMaximum = "Is Maximum", this property indicates whether the affected property values specified in the associated setting data instance shall define maximum setting values. When IsMaximum = "Is Not Maximum", this property indicates whether the affected property values specified in the associated setting data instance shall not define maximum setting values. When IsMaximum = "Unknown", this property indicates whether the affected property values specified in the associated setting data instance may correspond to maximum setting values. When IsMaximum = "Not Applicable", this property indicates whether the affected property values specified in the associated setting data instance shall not be interpreted with respect to whether each defines a maximum. This property is inherited from CIM_ElementSettingData and is always set to 0.

IsMinimum

Data type: uint16

Access type: Read-only

Qualifiers: Experimental

This property affects the interpretation of all non-null, non-enumerated, non-binary, numeric, non-key properties of the associated setting data instance. All other properties of the associated setting data instance are not affected by this property. Note: It is assumed that the semantics of each property of this set are designed to be compared mathematically. When IsMinimum = "Is Minimum", this property indicates whether the affected property values specified in the associated setting data instance shall define minimum setting values. When IsMinimum = "Is Not Minimum", this property indicates whether the affected property values specified in the associated setting data instance shall not define minimum setting values. When IsMinimum = "Unknown", this property indicates whether the affected property values specified in the associated setting data instance may correspond to minimum setting values. When IsMinimum = "Not Applicable", this property indicates whether the affected property values specified in the associated setting data instance shall not be interpreted with respect to whether each defines a minimum. This property is inherited from CIM_ElementSettingData and is always set to 0.

IsNext

Data type: uint16

Access type: Read-only

Qualifiers: Experimental

Indicates whether the referenced setting is the next setting to be applied. For example, the application could take place on a re-initialization, reset, reconfiguration request. This could be a permanent setting, or a setting used only one time, as indicated by the flag. If it is a permanent setting then the setting is applied every time the managed element reinitializes, until this flag is manually reset. However, if it is single use, then the flag is automatically cleared after the settings are applied. Also note that if this flag is specified (that is, set to value other than "Unknown"), then this takes precedence over any setting data that may have been specified as Default. For example: If the managed element is a computer system, and the value of this flag is "Is Next", then the setting will be effective next time the system resets. And, unless this flag is changed, it will persist for subsequent system resets. However, if this flag is set to "Is Next For Single Use", then this setting will only be used once and the flag would be reset after that to "Is Not Next". So, in the above example, if the system reboots in a quick succession, the setting will not be used at the second reboot. This property is inherited from CIM_ElementSettingData.

Unknown (0)

Unknown.

Is Next (1)

The setting will be applied to the managed element every time the managed element is reset.

Is Not Next (2)

This setting is no longer used.

Is Next For Single Use (3)

The setting will only be applied to the managed element once, and then this flag will be set to Is Not Next (2).

ManagedElement

Data type: Msvm_VLANEndpoint

Access type: Read-only

Qualifiers: Override ("ManagedElement")

The managed element. This will be a reference to an Msvm_VLANEndpoint object. This property is inherited from CIM_ElementSettingData.

SettingData

Data type: Msvm_VLANEndpointSettingData

Access type: Read-only

Qualifiers: Override ("SettingData")

The setting data object that is associated with the element. This will be a reference to an Msvm_VLANEndpointSettingData object. This property is inherited from CIM_ElementSettingData.

Remarks

Access to the Msvm_NetworkElementSettingData class might be restricted by UAC Filtering. For more information, see User Account Control and WMI.

Examples

See Querying Networking Objects.

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2008
End of client support
None supported
End of server support
Windows Server 2012 R2
Namespace
Root\Virtualization
MOF
WindowsVirtualization.mof

See also

CIM_ElementSettingData

CIM_ElementSettingData