Msvm_VirtualSystemSettingData 類別

發行項
06/12/2023

代表虛擬機器的虛擬化特定設定。

下列語法是簡化 Managed 物件格式 (MOF) 程式碼，並包含所有繼承的屬性。

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualSystemSettingData : CIM_VirtualSystemSettingData
{
  string   InstanceID;
  string   Caption = "Virtual Machine Settings";
  string   Description;
  string   ElementName;
  string   VirtualSystemIdentifier;
  string   VirtualSystemType;
  string   Notes[];
  datetime CreationTime;
  string   ConfigurationID;
  string   ConfigurationDataRoot;
  string   ConfigurationFile;
  string   SnapshotDataRoot;
  string   SuspendDataRoot;
  string   SwapFileDataRoot;
  string   LogDataRoot;
  uint16   AutomaticStartupAction;
  datetime AutomaticStartupActionDelay;
  uint16   AutomaticStartupActionSequenceNumber;
  uint16   AutomaticShutdownAction;
  uint16   AutomaticRecoveryAction;
  string   RecoveryFile;
  string   BIOSGUID;
  string   BIOSSerialNumber;
  string   BaseBoardSerialNumber;
  string   ChassisSerialNumber;
  string   Architecture;
  string   ChassisAssetTag;
  boolean  BIOSNumLock;
  uint16   BootOrder[];
  string   Parent;
  uint16   UserSnapshotType;
  boolean  IsSaved;
  string   AdditionalRecoveryInformation;
  boolean  AllowFullSCSICommandSet;
  uint32   DebugChannelId;
  uint16   DebugPortEnabled;
  uint32   DebugPort;
  string   Version;
  boolean  IncrementalBackupEnabled;
  boolean  VirtualNumaEnabled;
  boolean  AllowReducedFcRedundancy = False;
  string   VirtualSystemSubType;
  string   BootSourceOrder[];
  boolean  PauseAfterBootFailure;
  uint16   NetworkBootPreferredProtocol;
  boolean  GuestControlledCacheTypes;
  boolean  AutomaticSnapshotsEnabled;
  boolean  IsAutomaticSnapshot;
  string   GuestStateFile;
  string   GuestStateDataRoot;
  boolean  LockOnDisconnect;
  string   ParentPackage;
  datetime AutomaticCriticalErrorActionTimeout;
  uint16   AutomaticCriticalErrorAction;
  uint16   ConsoleMode;
  boolean  SecureBootEnabled;
  string   SecureBootTemplateId;
  uint64   LowMmioGapSize;
  uint64   HighMmioGapSize;
  uint16   EnhancedSessionTransportType;
};

成員

Msvm_VirtualSystemSettingData類別具有下列類型的成員：

屬性

屬性

Msvm_VirtualSystemSettingData類別具有這些屬性。

AdditionalRecoveryInformation

資料類型：字串
存取類型：讀取/寫入

提供給復原動作的任何其他資訊。此屬性的意義是由 AutomaticRecoveryAction中的動作所定義。如果 AutomaticRecoveryAction 為 0 (「None」) 或 1 (「Restart」) ，則此值為 Null。如果 AutomaticRecoveryAction 為 2 (「還原為快照集」) ，則這是虛擬機器背景工作進程失敗時應套用之快照集的物件路徑。

AllowFullSCSICommandSet

資料類型： 布林值
存取類型：讀取/寫入

如果來自客體作業系統的 SCSI 命令傳遞至傳遞磁片，則為True;否則為False。如果 為 True，則不會篩選客體作業系統對傳遞磁片發出的 SCSI 命令。我們建議 SCSI 篩選仍會針對生產環境部署啟用。

AllowReducedFcRedundancy

資料類型： 布林值
存取類型：讀取/寫入

指定是否允許使用虛擬光纖通道介面卡設定的虛擬機器即時移轉至目標光纖通道裝置路徑可能沒有或減少的目的地電腦。在即時移轉之後，應該清除此屬性。

值	意義
否	虛擬機器無法即時移轉至目的電腦，而目標光纖通道裝置的路徑可能沒有或減少。
是	虛擬機器可以即時移轉至目的電腦，該電腦可能沒有或減少目標光纖通道裝置的路徑。客體作業系統可能會失去儲存體的連線，而且可能會以無法預期的方式運作。

架構

資料類型：字串
存取類型：唯讀

此系統的架構。

注意

已在 Windows 10 1709 版中新增。

x64 ()

arm64 ()

AutomaticCriticalErrorAction

資料類型： uint16
存取類型：讀取/寫入

識別 VM 上要採取的動作，當發生重大錯誤時，例如儲存體中斷連線。

注意

已在 Windows 10 和 Windows Server 2016中新增。

無 (0)

不會針對重大錯誤狀況採取任何特定動作。

暫停繼續 (1)

導致 VM 在解決重大錯誤狀況時暫停並自動繼續。

AutomaticCriticalErrorActionTimeout

資料類型： datetime
存取類型：讀取/寫入
限定詞： SubType (「interval」)

識別要執行 AutomaticCriticalErrorAction 以解決重大錯誤的持續時間上限。只有當 AutomaticCriticalErrorAction 屬性的值不是 0 (None) 時，才適用這個值。逾時到期後，VM 將會關閉電源。此值會四捨五入到最接近的分鐘。值為 0 表示當 VM 遇到重大錯誤狀況時，應該立即關閉電源。

注意

已在 Windows 10 和 Windows Server 2016中新增。

AutomaticRecoveryAction

資料類型： uint16
存取類型：唯讀

當虛擬機器執行的軟體失敗時，要對虛擬機器採取的動作。在此情況下，失敗表示主機平臺可偵測到的失敗，例如不可中斷的等候狀態條件。此屬性繼承自 CIM_VirtualSystemSettingData。

這可以是下列其中一個值。

值	意義
2	無。
3	重新啟動。
4	還原為快照集。
5..32768	保留的。

AutomaticShutdownAction

資料類型： uint16
存取類型：唯讀

當主機關閉時，虛擬機器要採取的動作。此屬性繼承自 CIM_VirtualSystemSettingData。

這可以是下列其中一個值。

值	意義
2	關閉。
3	儲存狀態。
4	關機。
5..32768	保留的。

AutomaticSnapshotsEnabled

資料類型： 布林值
存取類型：讀取/寫入

指出此虛擬機器是否應該啟用自動快照集。

注意

已在 Windows 10 1709 版中新增。

AutomaticStartupAction

資料類型： uint16
存取類型：唯讀

啟動主機時要對虛擬機器採取的動作。此屬性繼承自 CIM_VirtualSystemSettingData。

這可以是下列其中一個值。

值	意義
2	無。
3	如果先前作用中，請重新開機。
4	一律啟動。
5..32768	保留的。

AutomaticStartupActionDelay

資料類型： datetime
存取類型：唯讀

虛擬機器自動啟動之前的延遲時間。此屬性繼承自 CIM_VirtualSystemSettingData。

AutomaticStartupActionSequenceNumber

資料類型： uint16
存取類型：唯讀

數位，指出啟動主機系統時虛擬機器啟用的相對順序。較低的數位表示先前的啟用。如果一或多個組態顯示相同的值，順序會相依于實作。值為 0 表示序列相依于實作。此屬性繼承自 CIM_VirtualSystemSettingData。

BaseBoardSerialNumber

資料類型：字串
存取類型：讀取/寫入

虛擬機器基底板的序號。

BIOSGUID

資料類型：字串
存取類型：讀取/寫入

虛擬機器 BIOS 的全域唯一識別碼。

BIOSNumLock

資料類型： 布林值
存取類型：讀取/寫入

如果 BIOS 將 num lock 鍵設定為 on，則為True;False表示 BIOS 設定為關閉 num 鎖定鍵。

BIOSSerialNumber

資料類型：字串
存取類型：讀取/寫入

虛擬機器的 BIOS 序號。

BootOrder

資料類型： uint16 陣列
存取類型：讀取/寫入
限定詞： ArrayType (「Indexed」) ， MAX (4)

虛擬機器 BIOS 內所設定的開機順序。此屬性是一個值陣列 BootOrder[0] 到 BootOrder[3]，其中包含每個值表示要開機的裝置。陣列中每個 4 個值都必須設定，且不得與陣列中的其他值相同。虛擬機器會先嘗試從陣列內第一個值所指示的裝置開機。如果該裝置不包含開機磁區，則虛擬機器會嘗試從 BootOrder 屬性所指定的下一個裝置開機，依此類錯。如果 BootOrder 內未指定任何裝置包含開機磁區，虛擬機器將無法開機。虛擬機器的預設值為 [0， 1， 2， 3]。

( 0)

虛擬機器會嘗試從磁片磁碟機內的磁片磁碟機開機。

CD-ROM (1)

虛擬機器會嘗試從使用開機磁區找到的第一個 CD 或 DVD 磁片開機。

IDE 硬碟 (2)

虛擬機器會嘗試從使用開機磁區找到的第一個硬碟開機。

PXE 開機 (3)

虛擬機器會嘗試從網路開機 PXE。

SCSI 硬碟 (4)

保留 (5..65535)

BootSourceOrder

資料類型：字串陣列
存取類型：讀取/寫入

虛擬機器的開機來源順序。

Windows 8.1：Windows 8.1 和 Windows Server 2012 R2 之前，不支援此值。

標題

資料類型：字串
存取類型：唯讀

物件的簡短描述。此屬性繼承自 CIM_ManagedElement。

ChassisAssetTag

資料類型：字串
存取類型：讀取/寫入

虛擬機器底座的資產標記。

ChassisSerialNumber

資料類型：字串
存取類型：讀取/寫入

虛擬機器底座的序號。

ConfigurationDataRoot

資料類型：字串
存取類型：唯讀

儲存虛擬機器組態相關資訊的目錄路徑。此屬性繼承自 CIM_VirtualSystemSettingData。

ConfigurationFile

資料類型：字串
存取類型：唯讀

儲存虛擬機器組態相關資訊之檔案的相對路徑和檔案名。此路徑相對於 ConfigurationDataRoot 屬性。此屬性繼承自 CIM_VirtualSystemSettingData。

ConfigurationID

資料類型：字串
存取類型：唯讀

虛擬機器組態的唯一識別碼。此屬性繼承自 CIM_VirtualSystemSettingData。

ConsoleMode

資料類型： uint16
存取類型：讀取/寫入

識別 VM 的主控台模式。

注意

此屬性已新增至 Windows 10 和 Windows Server 2016。

預設 (0)

COM1 (1)

COM2 (2)

無 (3)

CreationTime

資料類型： datetime
存取類型：唯讀

建立虛擬機器設定的日期和時間。如果這個物件代表虛擬機器的目前設定，這個值會是系統建立的時間。如果這個物件代表虛擬機器的快照集設定，這個值會是擷取快照集的時間。此屬性繼承自 CIM_VirtualSystemSettingData。

DebugChannelId

資料類型： uint32
存取類型：讀取/寫入

用來使用整合偵錯工具對虛擬機器進行偵錯的通道識別碼。

DebugPort

資料類型： uint32
存取類型：讀取/寫入

用來使用綜合偵錯對虛擬機器進行偵錯的 TCP/IP 埠。

DebugPortEnabled

資料類型： uint16
存取類型：讀取/寫入

指定虛擬機器是否使用綜合偵錯。這可以是下列其中一個值。

關閉 (0)

在 (1)

OnAutoAssigned (2)

自動指派

說明

資料類型：字串
存取類型：唯讀

對物件的描述。此屬性繼承自 CIM_ManagedElement，而且一律設定為下列其中一個值。

值	意義
「虛擬機器的作用中設定」	此實例是指虛擬機器。
「虛擬機器的快照集設定」	這個實例是指快照集。

ElementName

資料類型：字串
存取類型：唯讀

物件的顯示名稱。此屬性繼承自 CIM_VirtualSystemSettingData，而且一律會設定為電腦的顯示名稱。此名稱長度不可超過 100 個字元。

EnhancedSessionTransportType

資料類型： uint16
存取類型：讀取/寫入

指出連接到增強會話時要使用的傳輸類型。

注意

此屬性已新增Windows 10 1803 版。

VMBus Pipe (0)

Hyper-V 通訊端 (1)

GuestControlledCacheTypes

資料類型： 布林值
存取類型：讀取/寫入

指出來賓是否可以控制快取類型。

注意

已在 Windows 10 和 Windows Server 2016中新增。

GuestStateDataRoot

資料類型：字串
存取類型：唯讀

儲存客體執行時間狀態相關資訊之目錄的檔案路徑。

注意

已在 Windows 10 1709 版中新增。

GuestStateFile

資料類型：字串
存取類型：唯讀

儲存客體執行時間狀態相關資訊之檔案的檔案路徑。相對路徑會附加至 GuestStateDataRoot 屬性的值。

注意

已在 Windows 10 1709 版中新增。

HighMmioGapSize

資料類型： uint64
存取類型：讀取/寫入

高於 4GB) Memory-Mapped IO 間距的高 (大小 MB

注意

此屬性已新增Windows 10 1703 版。

IncrementalBackupEnabled

資料類型： 布林值
存取類型：讀取/寫入

指出 Hyper-V VSS 寫入器是否支援對此虛擬機器進行增量備份。

InstanceID

資料類型：字串
存取類型：唯讀
限定詞：金鑰

唯一識別這個類別的實例。此屬性繼承自 CIM_SettingData。

IsAutomaticSnapshot

資料類型： 布林值
存取類型：唯讀

指出這是否為使用者自動建立的快照集。

注意

已在 Windows 10 1709 版中新增。

IsSaved

資料類型： 布林值
存取類型：唯讀

如果組態具有已儲存狀態檔案的參考，則為 True;否則為 False。這不會指出這類檔案的存在，只有組態指定一個檔案。

LockOnDisconnect

資料類型： 布林值
存取類型：讀取/寫入

從 vmconnect 中斷連線時鎖定主控台。

注意

已新增至 Windows 10 和 Windows Server 2016。

LogDataRoot

資料類型：字串
存取類型：唯讀

儲存虛擬機器記錄資訊的目錄路徑。此屬性繼承自 CIM_VirtualSystemSettingData。

LowMmioGapSize

資料類型： uint64
存取類型：讀取/寫入

設定虛擬機器第一個 MMIO 間距的大小，以 MB 為單位， (VM) 。

Windows 8.1：在 Windows 8.1 和 Windows Server 2012 R2 之前，不支援此值。

範圍：128 3584

NetworkBootPreferredProtocol

資料類型： uint16
存取類型：讀取/寫入

判斷 PXE 開機的慣用通訊協定是否為 IPv4 或 IPv6。

Windows 8.1：在 Windows 8.1 和 Windows Server 2012 R2 之前，不支援此值。

IPv4 (4096)

IPv6 (4097)

注意事項

資料類型：字串陣列
存取類型：唯讀

使用者提供的附注與虛擬機器相關。此屬性繼承自 CIM_VirtualSystemSettingData。

父系

資料類型：字串
存取類型：唯讀

如果這個實例未代表以虛擬機器快照集為基礎的系統，則此屬性為 Null。否則，屬性會保存這個實例所依據 之Msvm_VirtualSystemSettingData 物件的物件路徑。為虛擬機器建置快照式樹狀結構階層時，此屬性會參考從中衍生目前實例的物件， (目前的實例是子節點，而此屬性中所參考的物件是父節點。)

ParentPackage

資料類型：字串
存取類型：讀取/寫入

如果此系統是容器，則此系統所依據之Msvm_ContainerPackage的路徑。

注意

已在 Windows 10 中新增;已從 Windows 10 1703 版中移除。

PauseAfterBootFailure

資料類型： 布林值
存取類型：讀取/寫入

指出 BIOS 是否在每次開機專案失敗後暫停，等候使用者按下按鍵。如果 BIOS 暫停，則為True;否則為False。

Windows 8.1：在 Windows 8.1 和 Windows Server 2012 R2 之前，不支援此值。

RecoveryFile

資料類型：字串
存取類型：唯讀

儲存虛擬機器之復原相關資訊之檔案的完整路徑。此屬性繼承自 CIM_VirtualSystemSettingData。

SecureBootEnabled

資料類型： 布林值
存取類型：讀取/寫入

指出虛擬機器是否已啟用安全開機 (VM) 。 如果已啟用， 則為 True;否則為 False。

注意

安全開機只能針對第 2 代 VM 啟用。

Windows 8.1：在 Windows 8.1 和 Windows Server 2012 R2 之前，不支援此值。

SecureBootTemplateId

資料類型：字串
存取類型：讀取/寫入

UEFI 安全開機相關變數之範本的全域唯一識別碼。

這是唯讀屬性，但可以使用Msvm_VirtualSystemManagementService類別的ModifyVirtualSystem方法進行變更。

注意

已新增至 Windows 10 和 Windows Server 2016。

SnapshotDataRoot

資料類型：字串
存取類型：唯讀

儲存虛擬機器快照集相關資訊的目錄路徑。此屬性繼承自 CIM_VirtualSystemSettingData。

SuspendDataRoot

資料類型：字串
存取類型：唯讀

儲存虛擬機器暫止相關資訊的目錄路徑。此屬性繼承自 CIM_VirtualSystemSettingData。

SwapFileDataRoot

資料類型：字串
存取類型：唯讀

儲存虛擬機器之交換檔案的目錄路徑。此屬性繼承自 CIM_VirtualSystemSettingData。

UserSnapshotType

資料類型： uint16
存取類型：讀取/寫入

指出使用者定義的快照集類型。

注意

已新增至 Windows 10 和 Windows Server 2016。

停用 (2)

停用建立任何快照集。

ProductionFallbackToTest (3)

用於生產環境的資料一致快照集。當無法建立資料一致快照集時，執行具有應用程式狀態的快照集。

ProductionNoFallback (4)

用於生產環境的資料一致快照集。如果無法建立資料一致快照集，則不會建立具有應用程式狀態的快照集。

測試 (5)

快照集，其中包含測試和開發用途的記憶體和裝置資訊。

版本

資料類型：字串
存取類型：唯讀

格式為「major.minor」的虛擬機器版本，例如「2.0」。

VirtualNumaEnabled

資料類型： 布林值
存取類型：讀取/寫入
限定詞： ModelCorrespondence (「Msvm_ProcessorSettingData。MaxProcessorsPerNumaNode「、」Msvm_MemorySettingData。MaxMemoryBlocksPerNumaNode「)

True 是表示如果虛擬非統一記憶體存取 (NUMA) 節點投影到虛擬機器中; 如果虛擬機器會有單一節點，則為 False。如果 為 True，則會根據 Msvm_ProcessorSettingData.MaxProcessorsPerNumaNode 和 Msvm_MemorySettingData.MaxMemoryBlocksPerNumaNode 屬性的值來決定投影至虛擬機器的虛擬 NUMA 節點數目。

VirtualSystemIdentifier

資料類型：字串
存取類型：唯讀
限定詞：覆寫 (「CIM_VirtualSystemSettingData.VirtualSystemIdentifier」) ， ModelCorrespondence (「CIM_ComputerSystem。Name「)

這個設定資料所屬 CIM_ComputerSystem 物件的名稱。此屬性是來自 CIM_VirtualSystemSettingData的覆寫。

VirtualSystemSubType

資料類型：字串
存取類型：唯讀

此屬性的有效值為 Microsoft：Hyper-V：SubType：1 和 Microsoft：Hyper-V：SubType：2。第 1 代 VM 是子類型 1。第 2 代 VM 是子類型 2。

Windows 8.1：在 Windows 8.1 和 Windows Server 2012 R2 之前，不支援此值。

Microsoft：Hyper-V：SubType：1 (「Microsoft：Hyper-V：SubType：1」)

Microsoft：Hyper-V：SubType：2 (「Microsoft：Hyper-V：SubType：2」)

VirtualSystemType

資料類型：字串
存取類型：唯讀

指定設定資料所代表的虛擬機器類型。此屬性繼承自 CIM_VirtualSystemSettingData 類別。這會是下列其中一個值。

值	意義
「Microsoft：Hyper-V：System：Realized」	實現的虛擬機器。
「Microsoft：Hyper-V：System：Planned」	已規劃的虛擬機器。
「Microsoft：Hyper-V：Snapshot：Realized」	實現虛擬機器的快照集。
「Microsoft：Hyper-V：Snapshot：Recovery」	復原虛擬機器的快照集。
「Microsoft：Hyper-V：Snapshot：Planned」	已規劃虛擬機器的快照集。
「Microsoft：Hyper-V：Snapshot：Missing」	遺失的快照集。
「Microsoft：Hyper-V：Snapshot：Replica：Standard」	以時間為基礎的複寫點快照集。
「Microsoft：Hyper-V：Snapshot：Replica：ApplicationConsistent」	VSS 複寫點快照集。
「Microsoft：Hyper-V：Snapshot：Replica：PlannedFailover」	規劃的複寫快照集。

備註

Msvm_VirtualSystemSettingData 類別的 存取可能會受到 UAC 篩選的限制。如需詳細資訊，請參閱使用者帳戶控制和 WMI。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
命名空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

另請參閱

CIM_VirtualSystemSettingData
CIM_VirtualSystemSettingData
虛擬系統類別

共用方式為

Msvm_VirtualSystemSettingData 類別

語法

成員

屬性

備註

規格需求

另請參閱

意見反應

其他資源