Msvm_PlannedComputerSystem 類別

發行項
06/12/2023

表示已規劃的虛擬機器。

下列語法是簡化 Managed Object Format (MOF) 程式碼，其中包含所有繼承的屬性。

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_PlannedComputerSystem : CIM_ComputerSystem
{
  string   InstanceID;
  string   Caption = "Planned Virtual Machine";
  string   Description = "Microsoft Planned Virtual Machine";
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[] = { 2 };
  string   StatusDescriptions[] = { "The service is running normally" };
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState = 12;
  string   CreationClassName;
  string   Name;
  string   NameFormat;
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   Roles[];
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   Dedicated[];
  string   OtherDedicatedDescriptions[];
  uint16   ResetCapability;
  uint16   PowerManagementCapabilities[];
  uint16   AssignedNumaNodeList[];
  uint64   OnTimeInMilliseconds;
  uint32   ProcessID;
  datetime TimeOfLastConfigurationChange;
};

成員

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

方法
屬性

方法

Msvm_PlannedComputerSystem類別具有這些方法。

方法	Description
RequestStateChange	要求已規劃系統的狀態變更為指定的值。
SetPowerState	不支援這個方法。

屬性

Msvm_PlannedComputerSystem類別具有這些屬性。

AssignedNumaNodeList

資料類型： uint16 陣列
存取類型：唯讀
限定詞： ArrayType (「Indexed」)

目前指派給虛擬機器的 NUMA) 節點 (非一元記憶體存取陣列。

AvailableRequestedStates

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

指出用於起始狀態變更之RequestStateChange 方法 RequestedState參數的可能值。列出的值將是CIM_EnabledLogicalElementCapabilities相關聯實例 的 RequestedStatesSupported 屬性中包含的值子 集，其中選取的值是 CIM_EnabledLogicalElement 物件目前狀態的函式。如果實作能夠將一組可能的值公告為目前狀態的函式，這個屬性可以是非Null 。如果實作無法判斷可能值的集合做為目前狀態的函式，這個屬性會是 Null 。

此屬性繼承自 CIM_EnabledLogicalElement。

已啟用 (2)
已停用 (3)
關閉 (4)
離線 (6)
測試 (7)
延遲 (8)
停止 (9)
重新開機 (10)
重設 (11)
DMTF 保留 (。。)

標題

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

物件的簡短描述。此屬性繼承自 CIM_ManagedElement，而且一律會設定為「已規劃的虛擬機器」。

CommunicationStatus

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

指出檢測能夠與基礎 Managed 元素通訊。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

CreationClassName

資料類型：字串
存取類型：唯讀
限定詞： Key、 MaxLen ( 256 )

指出建立實例時所使用的類別或子類別名稱。搭配這個類別的其他索引鍵屬性使用時，這個屬性可讓這個類別及其子類別的所有實例唯一識別。此屬性繼承自 CIM_System 類別。

專用

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

值的陣列，指出計畫系統專用的目的，如果有的話，以及提供哪些功能。例如，您可以指定系統專用於「Print」 (value=11) ，或做為「Hub」 (value=8) 。也可以指出多個用途。例如，這是一般用途系統，指出「Not Dedicated」 (value=0) ，但它也會裝載「Print」 (value=11) 或「Mobile User Device」 (value=17) 服務。

此屬性繼承自 CIM_ComputerSystem 類別。

值	意義
非專用 0
Unknown 1
其他 2
存放裝置 3
路由器 4
開關 5
第 3 層交換器 6
中央 Office 交換器 7
中心 8
存取伺服器 9
防火牆 10
Print 11
I/O 12
Web 快取 13
管理 14	指出此實例專用於裝載系統管理軟體。
封鎖伺服器 15
檔案伺服器 16
行動使用者裝置 17	專用行動使用者裝置的範例是行動電話或商店中的條碼掃描器，可透過無線電頻率進行通訊。這些系統在功能和可程式性上相當有限，而且不會被視為一般用途運算平臺。或者，一般用途 (行動系統的範例，不是專用) 是一部手部電腦。雖然其可程式性有限，但可以下載新的軟體，並由使用者擴充其功能。
中繼器 18
橋接器/擴充器 19
閘道 20
儲存體虛擬化工具 21
媒體櫃 22
ExtenderNode 23
NAS 前端 24
獨立式 NAS 25
UPS 26
IP 電話 27
管理控制器 28	表示這個實例代表專用於系統管理 (的特殊硬體，也就是基礎板管理控制器 (BMC) 或服務處理器) 。管理控制器的管理範圍通常是包含在其中的單一受控系統。
底座管理員 29	表示此實例代表專用於管理刀鋒視窗底座及其內含裝置的系統。這個值會用來代表「架板控制器」。底座管理員是管理的匯總點，可能依賴從屬管理控制器來管理組成元件。
主機型 RAID 控制器 30	表示這個實例代表主機電腦內含的 RAID 儲存控制器。
存放裝置主機殼 31	表示這個實例代表包含存放裝置的主機殼。
Desktop (電腦) 32
筆記本電腦 33
虛擬磁帶媒體櫃 34	虛擬媒體櫃系統的磁帶媒體櫃模擬。
虛擬程式庫系統 35	使用磁片儲存體來模擬磁帶媒體櫃。
網路電腦/精簡用戶端 36
FC 交換器 37	指出此實例專用於切換第 2 層光纖通道框架。
乙太網路交換器 38	指出此實例專用於切換第 2 層乙太網路框架。
DMTF 保留 39..32567
廠商保留 32568..65535

說明

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

對物件的描述。此屬性繼承自 CIM_ManagedElement，且一律設定為「Microsoft Planned Virtual Machine」。

DetailedStatus

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

以其他狀態詳細資料補充 PrimaryStatus 屬性。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

ElementName

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

物件的顯示名稱。此屬性繼承自 CIM_ManagedElement。

EnabledDefault

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

系統管理員的元素啟用狀態的預設或啟動組態。此屬性繼承自 CIM_EnabledLogicalElement，可以是下列其中一個值。

值	意義
停用 3	系統已關閉。
已啟用但離線 6	系統已啟用，但離線。將會卸載任何新的要求。

EnabledState

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

指定已規劃系統的啟用狀態。此屬性繼承自 CIM_EnabledLogicalElement，它可以是下列其中一個值。

值	意義
停用 3	系統已關閉。
已啟用但離線 6	系統已啟用，但離線。將會卸載任何新的要求。

HealthState

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

專案目前的健全狀況。這個屬性工作表示這個專案的健康情況，但不一定表示其子元件的健全狀況。可能的值為 0 到 30，其中 5 表示元素狀況完全良好，而 30 表示元素完全非功能。此屬性繼承自 CIM_ManagedSystemElement，而且一律設定為 5 (OK) 。

值	意義
5	健康情況狀態正常。

IdentifyingDescriptions

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

字串陣列，提供 OtherIdentificationInfo 陣列中專案背後的說明和詳細資料。此陣列的每個專案都與位於相同索引之 OtherIdentificationInfo 中的專案相關。此屬性繼承自 CIM_System 類別。

InstallDate

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

建立虛擬機器組態的日期和時間。此屬性繼承自 CIM_ManagedSystemElement。

InstanceID

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

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

名稱

資料類型：字串
存取類型：唯讀
限定詞： 索引鍵、覆寫、 MaxLen ( 256 )

繼承的名稱可作為企業環境中系統實例的索引鍵。此屬性繼承自 CIM_System 類別。

NameFormat

資料類型：字串
存取類型：唯讀
限定詞： MaxLen ( 64 )

使用子類別的啟發學習法，識別系統名稱的產生方式。系統物件及其衍生專案是 CIM 的最上層物件。它們提供許多元件的範圍。需要有唯一的系統金鑰。啟發學習法可以在個別系統子類別中定義，以嘗試一律產生相同的系統名稱索引鍵。此屬性繼承自 CIM_System 類別。

OnTimeInMilliseconds

資料類型： uint64
存取類型：唯讀
限定詞：單位 (「MilliSeconds」)

上次開啟、重設或還原虛擬機器後的總時間，以毫秒為單位。這次會排除虛擬機器處於暫停狀態的時間。

OperatingStatus

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

提供專案作業條件的目前狀態資訊，並可用來提供 與 EnabledState 屬性值相關的詳細資料。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

OperationalStatus

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

物件的目前狀態。此屬性繼承自 CIM_ManagedSystemElement，而且每個陣列元素一律會設定為 2 (OK) 。

OtherDedicatedDescriptions

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

字串，描述當 Dedicated 陣列包含值 2「Other」時，系統如何或為何專用。此屬性繼承自 CIM_ComputerSystem 類別。

OtherEnabledState

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

字串，描述 EnabledState 屬性設定為 1 (「Other」) 時，元素的啟用或停用狀態。當EnabledState是 1 以外的任何值時，此屬性必須設定為Null。此屬性繼承自 CIM_EnabledLogicalElement，而且一律設定為 Null。

OtherIdentifyingInfo

資料類型：字串陣列
存取類型：唯讀
限定詞： Key、 MaxLen ( 256 )

除了系統名稱資訊之外，還包含可用來識別 ComputerSystem 的其他資料。其中一個範例是保存節點的光纖通道全網名稱 (WWN) 。如果只有光纖通道名稱可用且是唯一的 (能夠作為系統金鑰) ，則此屬性會是 Null ，而 WWN 會成為系統索引鍵，其資料會放在 Name 屬性中。此屬性繼承自 CIM_System 類別。

PowerManagementCapabilities

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

此屬性繼承自 CIM_ComputerSystem 類別，但不受支援。

PrimaryOwnerContact

資料類型：字串
存取類型：讀取/寫入
限定詞： MaxLen ( 256 )

字串，提供主要系統擁有者如何連線 (例如電話號碼、電子郵件地址等) 的資訊。此屬性繼承自 CIM_System 類別。

PrimaryOwnerName

資料類型：字串
存取類型：讀取/寫入
限定詞： MaxLen ( 64 )

主要系統擁有者的名稱。系統擁有者是系統的主要使用者。此屬性繼承自 CIM_System 類別。

PrimaryStatus

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

提供高階狀態資訊。此屬性應該與 DetailedStatus 屬性搭配使用，以提供元素及其子元件的高階和詳細健康狀態資訊。 Null值表示這個屬性未實作。此屬性繼承自 CIM_ManagedSystemElement。

ProcessID

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

執行這個虛擬機器的進程識別碼。這個值可用來唯一識別執行虛擬機器之系統上Vmwp.exe的實例。

RequestedState

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

專案的最後一個要求或所需狀態。專案的實際狀態是由 EnabledState表示。提供這個屬性來比較元素的最後一個要求和目前狀態。 CIM_EnabledLogicalElement類別的特定實例可能不支援RequestedState屬性。如果發生這種情況，則會使用值 12 (「不適用」) 。此屬性繼承自 CIM_EnabledLogicalElement，而且一律會設定為 12 (不適用) 。

值	意義
12	不適用。

ResetCapability

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

指定電腦系統的重設功能。此屬性繼承自 CIM_ComputerSystem 類別。

值	意義
其他 1
Unknown 2
Disabled 3	不允許重設硬體。
Enabled 4	例如，可以使用硬體 (來重設電腦系統，例如電源和重設按鈕) 。
未實作 5

角色

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

字串陣列，指定系統在 Managed 環境中扮演的系統管理員定義角色。範例可能是「建置 8 個列印伺服器」或「布林使用者目錄」。單一系統可能會執行多個角色。系統角色的檢測檢視是由具現化系統的特定子類別或子類別中的屬性或兩者所定義。例如，ComputerSystem 的用途是使用 Dedicated 和 OtherDedicatedDescription 屬性來定義。此屬性繼承自 CIM_System 類別。

狀態

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

此屬性繼承自 CIM_ManagedSystemElement，但不會使用。

StatusDescriptions

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

描述各種 OperationalStatus 陣列值的字串。此屬性繼承自 CIM_ManagedSystemElement，而且每個陣列元素一律會設定為「服務正常執行」。

TimeOfLastConfigurationChange

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

上次修改虛擬機器組態檔的日期和時間。組態檔會在特定虛擬機器作業期間修改，以及新增、修改或移除任何虛擬機器或裝置設定時。

TimeOfLastStateChange

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

上次變更專案啟用狀態的日期和時間。此屬性繼承自 CIM_EnabledLogicalElement，但不受支援。

TransitioningToState

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

指出實例正在轉換的目標狀態。此屬性繼承自 CIM_EnabledLogicalElement。

值	意義
Unknown 0
Enabled 2
Disabled 3
關閉 4
無變更 5	沒有任何轉換正在進行中。
離線 6
Test 7
推遲 8
靜止 9
重新啟動 10
重設 11
不適用 12	實作不支援表示進行中的轉換。
DMTF 保留 ..

規格需求

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

另請參閱

CIM_ComputerSystem
Msvm_VirtualSystemManagementService 。ImportSystemDefinition 方法

共用方式為

Msvm_PlannedComputerSystem 類別

語法

成員

方法

屬性

規格需求

另請參閱

意見反應

其他資源