CIM_VirtualSystemSettingData 類別

發行項
06/12/2023

透過一組虛擬化特定屬性描述虛擬系統的虛擬層面。 CIM_VirtualSystemSettingData 也作為虛擬系統組態的最上層類別。

語法

[Abstract, Version("2.25.0"), UMLPackagePath("CIM::System::SystemElements"), AMENDMENT]
class CIM_VirtualSystemSettingData : CIM_SettingData
{
  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;
};

成員

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

屬性

屬性

CIM_VirtualSystemSettingData類別具有這些屬性。

AutomaticRecoveryAction

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

當虛擬系統執行的軟體失敗時，要對虛擬系統採取的動作。此屬性所解決的失敗只會包含主機平臺可偵測到的失敗，例如不可中斷的等候狀態條件。

無 (2)

重新開機 (3)

還原至快照 集 (4)

DMTF 保留 (。。)

AutomaticShutdownAction

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

當主機關閉時，要對虛擬系統採取的動作。

關閉 (2)

儲存狀態 (3)

關機 (4)

DMTF 保留 (。。)

AutomaticStartupAction

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

啟動主機時，要對虛擬系統採取的動作。

無 (2)

如果先前使用 中 (3) ，請重新開機

一律啟動 (4)

DMTF 保留 (。。)

AutomaticStartupActionDelay

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

啟動動作的延遲。這個值是 datetime 資料類型的間隔變體。

AutomaticStartupActionSequenceNumber

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

啟動主機系統時，虛擬系統啟用的序號。較低的數位表示先前的啟用。如果一或多個組態顯示相同的值，順序會相依于實作。值為「0」表示序列相依于實作。

ConfigurationDataRoot

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

儲存虛擬系統組態相關資訊之目錄的檔案路徑。此屬性的格式是以 RFC 2079 為基礎的 URI。

ConfigurationFile

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

儲存虛擬系統組態相關資訊之檔案的相對路徑。相對路徑會附加至 ConfigurationDataRoot 屬性的值。此屬性的格式是以 RFC 2079 為基礎的 URI。

ConfigurationID

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

虛擬系統組態的唯一識別碼。

注意

ConfigurationID 與 InstanceID不同，實作會指派給虛擬系統或虛擬系統組態。 ConfigurationID 不是索引鍵，而且一個以上的實例可能會發生相同的值。

CreationTime

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

建立虛擬系統組態的日期和時間。

LogDataRoot

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

儲存虛擬系統記錄資訊的目錄相對檔案路徑。相對路徑會附加至 ConfigurationDataRoot 屬性的值。此屬性的格式是以 RFC 2079 為基礎的 URI。

注意事項

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

陣列，其中包含與虛擬系統相關的使用者提供附注。

RecoveryFile

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

儲存虛擬系統之復原相關資訊的檔案路徑。此屬性的格式是以 RFC 2079 為基礎的 URI。

SnapshotDataRoot

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

儲存虛擬系統快照集相關資訊之目錄的相對路徑。相對路徑會附加至 ConfigurationDataRoot 屬性的值。此屬性的格式是以 RFC 2079 為基礎的 URI。

SuspendDataRoot

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

儲存虛擬系統暫止相關資訊之目錄的相對路徑。相對路徑會附加至 ConfigurationDataRoot 屬性的值。此屬性的格式是以 RFC 2079 為基礎的 URI。

SwapFileDataRoot

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

儲存虛擬系統交換檔案之目錄的相對檔案路徑。相對路徑會附加至 ConfigurationDataRoot 屬性的值。此屬性的格式是以 RFC 2079 為基礎的 URI。

VirtualSystemIdentifier

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

虛擬化平臺內系統的唯一名稱。 VirtualSystemIdentifier 不是指派給虛擬系統內執行之作業系統實例的主機名稱，也不是指派給其任何網路埠的 IP 位址或 MAC 位址。

VirtualSystemIdentifier可能包含實作特定規則，例如簡單模式或實作在設定VirtualSystemIdentifier時，可由實作解譯的正則運算式。

VirtualSystemType

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

虛擬系統的型別。

注意

如果虛擬系統類型未知，此值必須設定為「DMTF：unknown」。

此屬性會使用下列擴增 Backus Naur Form (ABNF) 格式來格式化：

vs-type = dmtf-value / other-org-value / legacy-value;dmtf-value = 「DMTF：」 defining-org 「：」 org-vs-type;other-org-value = defining-org 「：」 org-vs-type;

上述 ABNF 格式的值如下：

dmtf-value DMTF 所定義的屬性值，定義于此屬性的描述中。
other-org-value 是由 DMTF 以外的商業實體所定義的屬性值，而且未定義于此屬性的描述中。
舊版值 由 DMTF 以外的商業實體所定義的屬性值，而且未定義于此屬性的描述中。允許這些值，但建議隨著時間淘汰。
定義組織 定義虛擬系統類型的商務實體識別碼。它應該包含著作權、商標或商務實體所擁有的唯一名稱。它不應為「DMTF」，且不得包含冒號。
org-vs-type 定義商業實體內虛擬系統類型的識別碼。定義組織內應該是唯一的。org-vs-type 可以使用 CIM 字串允許的任何字元，但下列情況除外：U0000-U001F (Unicode C0 控制項) 、U0020 (空格) 、U007F (Unicode C0 控制項) 或 U0080-U009F (Unicode C1 控制項) 。
如果需要將值結構化成區段，則區段應該以單一冒號分隔。
此屬性的值應該區分大小寫處理。它們旨在以程式設計方式處理，而不是顯示名稱，而且應該簡短。

規格需求

需求	值
最低支援的用戶端	Windows 8
最低支援的伺服器	Windows Server 2012
命名空間	Root\virtualization\v2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

另請參閱

CIM_SettingData

共用方式為

CIM_VirtualSystemSettingData 類別

語法

成員

屬性

規格需求

另請參閱

意見反應

其他資源