Export (0) Print
Expand All

Msvm_VirtualSystemManagementServiceSettingData class

Hyper-V

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(True), Provider("VmmsWmiInstanceAndMethodProvider")]class Msvm_VirtualSystemManagementServiceSettingData : CIM_SettingData
{
  string  Caption = "Virtual System Management Service";
  string  Description = "Settings for the Virtual System Management Service";
  string  ElementName = "Virtual System Management Service";
  string  InstanceID = "Microsoft:host";
  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

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

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

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

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.

ValueMeaning
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)

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)

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

Namespace

\\.\Root\Virtualization

MOF

WindowsVirtualization.mof

See also

CIM_SettingData
Virtual System Management Classes

 

 

Community Additions

ADD
Show:
© 2015 Microsoft