Msvm_VirtualSystemGlobalSettingData class

Article
05/31/2018

Represents the global settings for a virtual system. These settings do not change if a new snapshot is applied to the virtual system.

The Msvm_VirtualSystemGlobalSettingData class is derived from CIM_VirtualSystemSettingData.

Windows Server 2008: The Msvm_VirtualSystemGlobalSettingData class is derived from CIM_SettingData.

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_VirtualSystemGlobalSettingData : CIM_VirtualSystemSettingData
{
  string   Caption = "Global Virtual Machine Settings";
  string   Description = "Global settings for the virtual machine";
  string   SystemName = "GUID";
  string   InstanceID = "Microsoft:GUID\Global";
  string   ElementName = "Global Virtual Machine Settings";
  uint16   VirtualSystemType = 301;
  boolean  AutoActivate;
  string   OtherVirtualSystemType;
  datetime CreationTime;
  string   ExternalDataRoot;
  uint16   SettingType = 32768;
  string   SnapshotDataRoot;
  uint16   AutomaticStartupAction = 1;
  datetime AutomaticStartupActionDelay = 00000000000000.000000:000;
  uint16   AutomaticShutdownAction = 1;
  uint16   AutomaticRecoveryAction = 1;
  string   AdditionalRecoveryInformation;
  string   ScopeOfResidence;
  uint32   DebugChannelId;
  uint32   DebugPort;
  uint16   DebugPortEnabled;
  boolean  AllowFullSCSICommandSet = False;
  string   Version;
};

Members

The Msvm_VirtualSystemGlobalSettingData class has these types of members:

Properties

Properties

The Msvm_VirtualSystemGlobalSettingData class has these properties.

AdditionalRecoveryInformation

Data type: string
Access type: Read/write

Any additional information provided to the recovery action. The meaning of this property is defined by the action in AutomaticRecoveryAction. If AutomaticRecoveryAction is 0 (None) or 1 (Restart), this value is NULL. If AutomaticRecoveryAction is 2 (Revert to Snapshot), this is the object path to a snapshot that should be applied on failure of the virtual machine worker process.

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

AllowFullSCSICommandSet

Data type: boolean
Access type: Read/write

Indicates whether SCSI commands from the guest operating system are passed to pass-through disks. It is recommended that SCSI filtering remains enabled for production deployments.

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

Windows Server 2008: The AllowFullSCSICommandSet property is not supported before Windows Server 2008 R2.

Value	Meaning
False	SCSI commands emitted by the guest operating system to pass-through disks are filtered.
True	SCSI commands emitted by the guest operating system to pass-through disks are not filtered.

AutoActivate

Data type: boolean
Access type: Read-only

This property is inherited from CIM_VirtualSystemSettingData and it is set to NULL.

Windows Server 2008: The AutoActivate property is not supported before Windows Server 2008 R2.

AutomaticRecoveryAction

Data type: uint16
Access type: Read/write

The action to be taken if the virtual machine worker process terminates abnormally. The default action is 1 (Restart).

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

None (0)

Restart (1)

Revert to Snapshot (2)

AutomaticShutdownAction

Data type: uint16
Access type: Read/write

The action to take when the host is shut down. The default action is 1 (Save State).

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

Turn Off (0)

Save State (1)

ShutDown (2)

AutomaticStartupAction

Data type: uint16
Access type: Read/write

The action to be taken when the host is started. The default action is 1 ("Restart if Previously Running").

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

None (0)

None

Restart if Previously Running (1)

Restart if Previously Running

Always Startup (2)

Always Startup

AutomaticStartupActionDelay

Data type: datetime
Access type: Read/write
Qualifiers: SubType ("Interval")

The time interval to wait before performing the startup action. By default, there is no delay.

This is a read-only property, but it can be changed using the ModifyVirtualSystem 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 "Global Virtual Machine Settings".

CreationTime

Data type: datetime
Access type: Read-only

The date or time when the virtual system setting data was created. For snapshots, this value corresponds to the time at which the snapshot was taken. For non-snapshots, this value corresponds to the time at which the virtual system was created. This property is inherited from CIM_VirtualSystemSettingData.

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

Windows Server 2008: The CreationTime property is not supported before Windows Server 2008 R2.

DebugChannelId

Data type: uint32
Access type: Read/write

The channel identifier used to debug the virtual system using the VUD unified debugger.

DebugPort

Data type: uint32
Access type: Read/write

The tcpip port used to debug the virtual system using synthetic debugging.

DebugPortEnabled

Data type: uint16
Access type: Read/write

Whether the virtual system is using synthetic debugging.

Off (0)

On (1)

OnAutoAssigned (2)

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 "Global settings for the virtual machine".

ElementName

Data type: string
Access type: Read/write

A user-friendly name for the object. This property is inherited from CIM_ManagedElement and it defaults to "Global Virtual Machine Settings". Changing this property will change the ElementName of the associated Msvm_ComputerSystem derivative.

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

ExternalDataRoot

Data type: string
Access type: Read-only

The fully qualified path to the root directory of an external data store. This store is managed by the virtual system management service and may contain private data from multiple virtual systems. This property may be specified only at the time the virtual machine is defined.

This is a read-only property, but it can be changed before the virtual machine is created using the DefineVirtualSystem method of the Msvm_VirtualSystemManagementService class.

InstanceID

Data type: string
Access type: Read-only

This property is inherited from CIM_SettingData and it is set to "Microsoft:GUID\Global".

OtherVirtualSystemType

Data type: string
Access type: Read-only
Qualifiers: ModelCorrespondence ("CIM_VirtualSystemSettingData.VirtualSystemType")

This property is inherited from CIM_VirtualSystemSettingData and it is set to NULL.

Windows Server 2008: The OtherVirtualSystemType property is not supported before Windows Server 2008 R2.

ScopeOfResidence

Data type: string
Access type: Read/write

The authorization scope to use in determining the access control policy for this virtual system.

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

SettingType

Data type: uint16
Access type: Read-only
Qualifiers: Override (SettingType)

This property is inherited from CIM_VirtualSystemSettingData and it is set to 32768, which means "Global setting type".

Windows Server 2008: The SettingType property is not supported before Windows Server 2008 R2.

Input (1)

Recorded (2)

Current (3)

Capability (4)

Snapshot (5)

Global (32768)

SnapshotDataRoot

Data type: string
Access type: Read-only

The fully qualified path to the root directory of the external data store used to store snapshots for this virtual system. This store is managed by the virtual system management service and may contain private data from multiple virtual systems. Changes made to this property affect only snapshots taken subsequent to the change.

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

SystemName

Data type: string
Access type: Read/write

The label by which the object is known. This property is inherited from CIM_VirtualSystemSettingData and it is set to "GUID". This corresponds to the Name property of the associated Msvm_ComputerSystem class and the SystemName property of the associated Msvm_VirtualSystemSettingData class.

Windows Server 2008: The SystemName property is not supported before Windows Server 2008 R2.

Version

Data type: string
Access type: Read-only

The version of the virtual system in a format of "major.minor", for example "2.0".

Windows Server 2008: The Version property is not supported before Windows Server 2008 R2.

VirtualSystemType

Data type: uint16
Access type: Read-only
Qualifiers: ModelCorrespondence ("CIM_VirtualSystemSettingData.OtherVirtualSystemType")

This property is inherited from CIM_VirtualSystemSettingData and it is set to 301, which means "Hyper-V".

Windows Server 2008: The VirtualSystemType property is not supported before Windows Server 2008 R2.

Remarks

Access to the Msvm_VirtualSystemGlobalSettingData 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

Share via

Msvm_VirtualSystemGlobalSettingData class

Syntax

Members

Properties

Remarks

Requirements

See also

Additional resources