Msvm_VirtualSystemManagementServiceSettingData class

Represents the settings for the virtualization service present on a single host system. The properties for this class cannot be modified directly. The client must call the ModifyServiceSettings method of the Msvm_VirtualSystemManagementService class to modify any of these properties.

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_VirtualSystemManagementServiceSettingData : CIM_SettingData
{
  string  Caption = "Virtual System Management Service";
  string  Description = "Settings for the Virtual System Management Service";
  string  InstanceID = "Microsoft:host";
  string  ElementName = "Virtual System Management Service";
  string  PrimaryOwnerName = "Administrators";
  string  PrimaryOwnerContact = "";
  string  ScopeOfResidence = "";
  string  DefaultExternalDataRoot = "root\ProgramData\Microsoft\Windows\Virtualization";
  string  DefaultVirtualHardDiskPath = "root\Users\Public\Documents\Virtual Hard Disks";
  string  MinimumMacAddress;
  string  MaximumMacAddress;
  boolean NumaSpanningEnabled;
  string  BiosLockString;
};

Members

The Msvm_VirtualSystemManagementServiceSettingData class has these types of members:

• Properties

Properties

The Msvm_VirtualSystemManagementServiceSettingData class has these properties.

BiosLockString

Data type: string

Access type: Read-only

Qualifiers: Maxlen (32)

Used by OEMs to allow BIOS-locked Windows operating systems to run in the virtual machine. This string must be exactly 32 characters in length.

This is a read-only property, but it can be changed using the ModifyServiceSettings method of the Msvm_VirtualSystemManagementService class.

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen (64)

A short textual description (one-line string) of the object. This property is inherited from CIM_ManagedElement and it is set to "Virtual System Management Service".

DefaultExternalDataRoot

Data type: string

Access type: Read-only

Qualifiers: ModelCorrespondence ("Msvm_ComputerSystem.ExternalDataRoot")

The default external data root. By default, "root\ProgramData\Microsoft\Windows\Virtualization".

This is a read-only property, but it can be changed using the ModifyServiceSettings method of the Msvm_VirtualSystemManagementService class.

DefaultVirtualHardDiskPath

Data type: string

Access type: Read-only

The default virtual hard disk path. By default, "root\Users\Public\Documents\Virtual Hard Disks".

This is a read-only property, but it can be changed using the ModifyServiceSettings method of the Msvm_VirtualSystemManagementService class.

Description

Data type: string

Access type: Read-only

A textual description of the object. This property is inherited from CIM_ManagedElement and it is set to "Settings for the Virtual System Management Service".

ElementName

Data type: string

Access type: Read-only

Qualifiers: Required

A user-friendly name for the object. This property is inherited from CIM_ManagedElement and it is set to "Virtual System Management Service". Changing this property will change the ElementName property of the associated CIM_LogicalDevice derivative.

InstanceID

Data type: string

Access type: Read-only

Qualifiers: Key

This property is inherited from CIM_SettingData and it is set to "Microsoft:host", where host is the NetBIOS name of the hosting computer system.

MaximumMacAddress

Data type: string

Access type: Read-only

The maximum MAC address for dynamically generated MAC addresses.

This is a read-only property, but it can be changed using the ModifyServiceSettings method of the Msvm_VirtualSystemManagementService class.

MinimumMacAddress

Data type: string

Access type: Read-only

The minimum MAC address for dynamically generated MAC addresses.

This is a read-only property, but it can be changed using the ModifyServiceSettings method of the Msvm_VirtualSystemManagementService class.

NumaSpanningEnabled

Data type: boolean

Access type: Read-only

Specifies if memory can be allocated from remote nonuniform memory access (NUMA) nodes when starting a VM or when assigning memory to a VM by dynamic memory. This can be one of the following values.

Value	Meaning
TRUE	Memory can be allocated from both local and remote NUMA nodes.
FALSE	Memory can be allocated only from the NUMA node assigned to the VM.

This is a read-only property, but it can be changed by using the ModifyServiceSettings method of the Msvm_VirtualSystemManagementService class.

Windows Server 2008 R2: Reserved for future use. Note that this behavior has changed with Windows Server 2008 R2 with SP1.

Windows Server 2008: The NumaSpanningEnabled property is not available before Windows Server 2008 R2.

PrimaryOwnerContact

Data type: string

Access type: Read-only

Qualifiers: Maxlen (256), Mappingstrings ("MIF.DMTF|General Information|001.4")

Describes how the primary system owner can be reached (for example, phone number or email address). By default, empty. This name may not exceed 256 characters in length.

This is a read-only property, but it can be changed using the ModifyServiceSettings method of the Msvm_VirtualSystemManagementService class.

PrimaryOwnerName

Data type: string

Access type: Read-only

Qualifiers: Maxlen (64), Mappingstrings ("MIF.DMTF|General Information|001.3")

The name of the primary system owner. By default, "Administrators". This value may not exceed 64 characters in length.

This is a read-only property, but it can be changed using the ModifyServiceSettings method of the Msvm_VirtualSystemManagementService class.

ScopeOfResidence

Data type: string

Access type: Read-only

The scope. By default, empty.

This is a read-only property, but it can be changed using the ModifyServiceSettings method of the Msvm_VirtualSystemManagementService class.

Remarks

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

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_SettingData

CIM_SettingData

Virtual System Management Classes