Msvm_SystemExportSettingData class

Article
01/07/2021

Associates a virtual machine and its export setting data. Before calling the ExportSystemDefinition method of the Msvm_VirtualSystemManagementService class, an instance of Msvm_VirtualSystemExportSettingData can be retrieved using this association.

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_SystemExportSettingData : CIM_ElementSettingData
{
  CIM_ComputerSystem                  REF ManagedElement;
  Msvm_VirtualSystemExportSettingData REF SettingData;
  uint16                                  IsDefault = 1;
  uint16                                  IsCurrent = 1;
  uint16                                  IsNext = 0;
};

Members

The Msvm_SystemExportSettingData class has these types of members:

Properties

Properties

The Msvm_SystemExportSettingData class has these properties.

IsCurrent

Data type: uint16
Access type: Read-only

Indicates if the referenced setting is currently being used in the operation of the element, or that this information is unknown. This property is inherited from CIM_ElementSettingData.

Value	Meaning
0	Unknown
1	Current
2	Not Current

IsDefault

Data type: uint16
Access type: Read-only

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

Value	Meaning
0	Unknown
1	Default
2	Not Default

IsNext

Data type: uint16
Access type: Read-only

Indicates whether or not 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, if this flag is specified (i.e. set to value other than 0 (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 1 (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 3 (Is Next For Single Use), then this setting will only be used once and the flag would be reset after that to 2 (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.

Value	Meaning
0	Unknown
1	Is Next
2	Is Not Next
3	Is Next For Single Use

ManagedElement

Data type: CIM_ComputerSystem
Access type: Read-only
Qualifiers: Override ("CIM_ElementSettingData.ManagedElement")

Reference to the virtual machine. This property is inherited from CIM_ElementSettingData.

SettingData

Data type: Msvm_VirtualSystemExportSettingData
Access type: Read-only
Qualifiers: Override ("CIM_ElementSettingData.SettingData")

Reference to the export setting data for the virtual machine. This property is inherited from CIM_ElementSettingData.

Remarks

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

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

Share via