Msvm_ComputerSystem 類別

  • 發行項

表示實體電腦系統或虛擬機器。

若要擷取 VMMS 的資訊，請使用 Msvm_VirtualSystemManagementService 類別。

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

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_ComputerSystem : CIM_ComputerSystem
{
  string   InstanceID;
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState = 5;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  uint16   EnabledState = 2;
  string   OtherEnabledState;
  uint16   RequestedState;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState;
  string   CreationClassName;
  string   Name = "GUID";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   Roles[];
  string   NameFormat;
  string   OtherIdentifyingInfo[];
  string   IdentifyingDescriptions[];
  uint16   Dedicated[];
  string   OtherDedicatedDescriptions[];
  uint16   ResetCapability = 1;
  uint16   PowerManagementCapabilities[];
  uint64   OnTimeInMilliseconds;
  uint32   ProcessID;
  datetime TimeOfLastConfigurationChange;
  uint16   NumberOfNumaNodes;
  uint16   ReplicationState;
  uint16   ReplicationHealth;
  uint16   ReplicationMode;
  uint16   FailedOverReplicationType;
  uint16   LastReplicationType;
  DateTime LastApplicationConsistentReplicationTime;
  DateTime LastReplicationTime;
  DateTime LastSuccessfulBackupTime;
  uint16   EnhancedSessionModeState;
};

成員

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

方法

Msvm_ComputerSystem類別具有這些方法。

方法 Description
InjectNonMaskableInterrupt 將非遮罩式插斷插入虛擬機器。 這個方法僅支援代表虛擬機器 之 Msvm_ComputerSystem 類別的實例。
Windows 8.1：Windows 8.1和 Windows Server 2012 R2 之前，不支援此方法。
RequestReplicationStateChange 要求虛擬機器的複寫狀態變更為指定的值。 這個方法僅支援代表虛擬機器 之 Msvm_ComputerSystem 類別的實例。
RequestReplicationStateChangeEx 要求虛擬機器的複寫狀態變更為指定的值。 這個方法僅支援代表虛擬機器 之 Msvm_ComputerSystem 類別的實例。
Windows 8.1：Windows 8.1和 Windows Server 2012 R2 之前，不支援此方法。
RequestStateChange 要求要變更虛擬機器的狀態。 這個方法僅支援代表虛擬機器 之 Msvm_ComputerSystem 類別的實例。
SetPowerState 不支援這個方法。

屬性

Msvm_ComputerSystem類別具有這些屬性。

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

資料類型： 字串

存取類型：唯讀

建立實例時所使用的類別或子類別名稱。 此屬性繼承自 CIM_System，而且一律設定為 「Msvm_ComputerSystem」。

專用

資料類型： uint16 陣列

存取類型：唯讀

指出電腦系統是否為特殊用途系統， (專用於特定用途的系統) ，而不是一般用途系統。 此屬性繼承自 CIM_ComputerSystem，而且一律設定為 0 (Not Dedicated) 。

說明

資料類型： 字串

存取類型：唯讀

對物件的描述。 這個屬性繼承自 CIM_ManagedElement，而且會包含下列其中一個值。

值 意義
「Microsoft 虛擬電腦系統」
 實例代表虛擬機器。
「Microsoft 主控電腦系統」
 實例代表主控電腦。

DetailedStatus

資料類型： uint16

存取類型：唯讀

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

ElementName

資料類型： 字串

存取類型：唯讀

物件的顯示名稱。 此屬性繼承自 CIM_ManagedElement，而且一律會設定為虛擬機器的電腦顯示名稱或管理作業系統的 NetBIOS 名稱。

EnabledDefault

資料類型： uint16

存取類型：唯讀

啟用專案狀態的系統管理員預設或啟動組態。 此屬性繼承自 CIM_EnabledLogicalElement ，而且會是下列其中一個值。

已啟用 (2)

已停用 (3)

已啟用但離線 (6)

EnabledState

資料類型： uint16

存取類型：唯讀

專案的啟用和停用狀態。 這個屬性也可以指出這些要求狀態之間的轉換。 此屬性繼承自 CIM_EnabledLogicalElement 類別，而且它設定為實體電腦的 2 (Enabled) ，或虛擬機器的下列其中一個值。 如需這些狀態的圖形檢視，請參閱。

值 意義
Unknown
0
 無法判斷專案的狀態。
其他
1
Enabled
2
 專案正在執行。
停用
3
 專案已關閉。
關閉
4
 專案正在進入 [已停用] 狀態。
不適用
5
 專案不支援啟用或停用。
已啟用但離線
6
 專案可能正在完成命令，而且會卸載任何新的要求。
在測試中
7
 專案處於測試狀態。
已延期
8
 元素可能正在完成命令，但會將任何新的要求排入佇列。
靜止
9
 專案已啟用，但處於受限制模式。 元素的行為類似于 enabled 狀態 (2) ，但只會處理一組受限的命令。 所有其他要求都會排入佇列。
啟動中
10
 元素正在進入 [啟用] 狀態， (2) 。 新要求會排入佇列。

EnhancedSessionModeState

資料類型： uint16

存取類型：唯讀

指定虛擬機器上增強會話模式的目前狀態。

每次Msvm_ComputerSystem類別的EnhancedSessionModeState變更時，Hyper-V WMI 提供者都會引發__InstanceModificationEvent。 如果作用中的 vmconnection 會話收到 __InstanceModificationEvent，當使用者啟用該設定時，它會嘗試切換到增強的會話模式。

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

EnhancedSessionModeState 可以是下列其中一個值：

允許和可用 (2)

虛擬機器上允許和提供增強模式。

不允許 (3)

虛擬機器上不允許增強模式。

允許但無法使用 (6)

允許增強模式，但目前無法在虛擬機器上使用。

FailedOverReplicationType

資料類型： uint16

存取類型：唯讀

限定詞： 已淘汰 (「Msvm_ReplicationRelationship。FailedOverReplicationType「)

容錯移轉作業期間套用的恢復資料點類型。

注意

此屬性從Windows 8.1開始已被取代;相反地，請使用Msvm_ReplicationRelationship類別中相同名稱的 屬性，以取得主要或擴充關聯性的值。

可能的值包括：

無 (0)

一般 (1)

應用程式一致 (2)

計畫 性 (3)

HealthState

資料類型： uint16

存取類型：唯讀

指定專案的目前健全狀況。 這個屬性工作表示這個專案的健康情況，但不一定是其子元件的健康情況。

發生重大錯誤時，請檢查事件記錄檔以取得詳細資料。 EnabledState屬性也可以包含詳細資訊。 例如，當磁碟空間嚴重不足時， HealthState 會設定為 25，虛擬機器會暫停，而 EnabledState 會設定為 32768 (Paused) 。

此屬性繼承自 CIM_ManagedSystemElement。

值 意義
確定
5
 虛擬機器功能完全正常，且在正常指令引數內運作，而且沒有錯誤。
主要失敗
20
 虛擬機器發生重大失敗。 當包含虛擬機器 VHD 的一或多個磁片磁碟空間不足且虛擬機器已暫停時，就會使用此值。
重大失敗
25
 元素為非功能，而且可能無法復原。 這表示虛擬機器的背景工作進程 (Vmwp.exe) 未回應控制或資訊要求，或有一或多個包含虛擬機器 VHD 的磁片磁碟空間不足。

IdentifyingDescriptions

資料類型： 字串 陣列

存取類型：唯讀

此屬性繼承自 CIM_ComputerSystem，而且一律設定為 Null。

InstallDate

資料類型： datetime

存取類型：唯讀

為虛擬機器建立虛擬機器組態的日期和時間，或針對管理作業系統建立 Null。 此屬性繼承自 CIM_ManagedSystemElement。

InstanceID

資料類型： 字串

存取類型：唯讀

限定詞： 金鑰

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

在Windows 8中，每部電腦系統或虛擬機器都有一個ReplicationSettingData實例。 針對Windows 8.1，復原虛擬機器有兩個ReplicationSettingData實例。 這項變更區分設定資料與複寫關聯性。

屬性名稱 Windows 8值 Windows 8.1值
InstanceID Microsoft： < vmguid > \HVR Microsoft： < vmguid > \HVR\ < 0/1>

在 Windows 8.1 值中，0 表示主要複寫，1 表示擴充複寫。 如需擴充複寫的詳細資訊，請參閱 Msvm_ReplicationRelationship。

LastApplicationConsistentReplicationTime

資料類型： DateTime

存取類型：唯讀

限定詞： 已淘汰 (「Msvm_ReplicationRelationship。LastApplicationConsistentReplicationTime「)

虛擬機器上次收到應用程式一致複寫的時間。

注意

從 Windows 8.1 開始，這個屬性已被取代;請改用Msvm_ReplicationRelationship類別中相同名稱的 屬性，以取得主要或擴充關聯性的值。

LastReplicationTime

資料類型： DateTime

存取類型：唯讀

限定詞： 已淘汰 (「Msvm_ReplicationRelationship。LastReplicationTime「)

在虛擬機器復原時收到上次複寫的時間。

注意

從 Windows 8.1 開始，這個屬性已被取代;請改用Msvm_ReplicationRelationship類別中相同名稱的 屬性，以取得主要或擴充關聯性的值。

LastReplicationType

資料類型： uint16

存取類型：唯讀

限定詞： 已淘汰 (「Msvm_ReplicationRelationship。LastReplicationType「)

針對虛擬機器收到的上次複寫類型。

注意

從 Windows 8.1 開始，這個屬性已被取代;請改用Msvm_ReplicationRelationship類別中相同名稱的 屬性，以取得主要或擴充關聯性的值。

可能的值包括：

無 (0)

一般 (1)

應用程式一致 (2)

計畫 性 (3)

LastSuccessfulBackupTime

資料類型： DateTime

存取類型：唯讀

上次成功備份虛擬機器的時間。

名稱

資料類型： 字串

存取類型：唯讀

已知物件的標籤。 此屬性繼承自 CIM_System，而且一律設定為 「GUID」。

NameFormat

資料類型： 字串

存取類型：唯讀

字串，識別系統名稱的產生方式，使用子類別啟發學習法。 此屬性繼承自 CIM_ComputerSystem，而且一律設定為 Null。

NumberOfNumaNodes

資料類型： uint16

存取類型：唯讀

電腦系統的 NUMA) 節點 (非單一記憶體存取數目。 當 Msvm_ComputerSystem 代表主控電腦系統時，此屬性會包含實體 NUMA 節點的計數。 當Msvm_ComputerSystem代表虛擬機器時，此屬性會包含透過 ACPI 系統資源親和性資料表向客體作業系統呈現的虛擬 NUMA 節點數目， (SRAT) 。

OnTimeInMilliseconds

資料類型： uint64

存取類型：唯讀

限定詞： 單位 (「MilliSeconds」)

對於虛擬機器，這個屬性會指出上次開啟、重設或還原機器之後的時間，以毫秒為單位。 這次會排除虛擬機器處於暫停狀態的時間。 針對管理作業系統，此屬性會設定為 Null。

OperatingStatus

資料類型： uint16

存取類型：唯讀

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

OperationalStatus

資料類型： uint16 陣列

存取類型：唯讀

陣列，包含物件的目前狀態。 此屬性繼承自 CIM_ManagedSystemElement。 索引零 (0) 的值是下列其中一個值。

值 意義
確定
2
 虛擬機器正常運作且正常運作。
已降級
3
 虛擬機器只會部分運作。 這表示無法存取包含設定的儲存體。 處於此狀態的虛擬機器只能關閉或刪除。
預測性失敗
5
 虛擬機器正常運作，但未來可能會失敗。 這表示包含虛擬機器虛擬硬碟的儲存體在可用空間不足。 如果未提供更多磁碟空間，虛擬機器將會暫停。
已停止
10
 不支援此值。 如果虛擬機器停止， EnabledState 屬性的值會是 3 (Disabled) 。
在服務中
11
 虛擬機器正在處理要求。
Dormant
15
 不支援此值。 如果虛擬機器已暫停或暫停， EnabledState 屬性的值會是 32769 (Suspended) 或 32768 (Paused) 。

索引 1 (1) 的值是選擇性的，而且包含次要狀態資訊。 用戶端應該使用索引零 (0) 的主要狀態來判斷是否可以將新的要求發出至虛擬機器。 如果 OperationalStatus[0] 為 2 (OK) ， 則 OperationalStatus[1] 所指示的作業可能會中斷。

OperationalStatus[1] 的值是下列其中一個值。

值 意義
建立快照集
32768
 快照集正在為虛擬機器建立。
套用快照集
32769
 快照集正在套用至虛擬機器。
刪除快照集
32770
 快照集正在從虛擬機器中刪除。
等候開始
32771
 在自動啟動延遲經過之後，將會啟動虛擬機器。
合併磁片
32772
 先前已刪除快照集的虛擬硬碟正在合併。
匯出虛擬機器
32773
 正在匯出虛擬機器。
移轉虛擬機器
32774
 虛擬機器正即時從一部實體電腦移轉至另一部電腦。

OtherDedicatedDescriptions

資料類型： 字串 陣列

存取類型：唯讀

字串，描述 當 Dedicated 陣列包含值 2 (Other) 時，系統為何專用。 此屬性繼承自 CIM_ComputerSystem，而且一律會設定為 Null。

OtherEnabledState

資料類型： 字串

存取類型：唯讀

當 EnabledState 屬性設定為 1 (Other) 時，虛擬機器的啟用或停用狀態。 當EnabledState是 1 以外的任何值時，此屬性必須設定為Null。 此屬性繼承自 CIM_EnabledLogicalElement，而且一律會設定為 Null。

OtherIdentifyingInfo

資料類型： 字串 陣列

存取類型：唯讀

此屬性繼承自 CIM_ComputerSystem，而且一律會設定為 Null。

PowerManagementCapabilities

資料類型： uint16 陣列

存取類型：唯讀

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

PrimaryOwnerContact

資料類型： 字串

存取類型：唯讀

字串，指出主要系統擁有者如何觸達 (例如電話號碼或電子郵件地址) 。 此屬性繼承自 CIM_System，而且一律會設定為 Null。

PrimaryOwnerName

資料類型： 字串

存取類型：唯讀

主要系統擁有者的名稱。 此屬性繼承自 CIM_System，而且一律會設定為 Null。

PrimaryStatus

資料類型： uint16

存取類型：唯讀

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

ProcessID

資料類型： uint32

存取類型：唯讀

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

ReplicationHealth

資料類型： uint16

存取類型：唯讀

限定詞： 已淘汰 (「Msvm_ReplicationRelationship。ReplicationHealth「)

虛擬機器的複寫健康情況。

注意

此屬性從Windows 8.1開始已被取代;相反地，請使用Msvm_ReplicationRelationship類別中相同名稱的 屬性，以取得主要或擴充關聯性的值。

可能的值包括：

不適用 (0)

確定 (1)

警告 (2)

重大 (3)

ReplicationMode

資料類型： uint16

存取類型：唯讀

指定虛擬機器的複寫模式。 這會是下列其中一個值。

無 (0)

主要 (1)

複 本 (2)

復原

測試複本 (3)

複本

擴充複 本 (4)

ReplicationState

資料類型： uint16

存取類型：唯讀

限定詞： 已淘汰 (「Msvm_ReplicationRelationship。ReplicationState「)

虛擬機器的複寫狀態。

注意

此屬性從Windows 8.1開始已被取代;相反地，請使用Msvm_ReplicationRelationship類別中相同名稱的 屬性，以取得主要或擴充關聯性的值。

可能的值包括：

已停用 (0)

準備好複寫 (1)

等候完成初始複 寫 (2)

複寫 (3)

同步複寫完成 (4)

復原 (5)

認可 (6)

暫停 (7)

重大 (8)

等候開始重新同步處理 (9)

重新同步處理 (10)

重新同步處理已暫停 (11)

容錯移轉進行 中 (12)

進行中的容錯回復 (13)

容錯回復完成 (14)

RequestedState

資料類型： uint16

存取類型：唯讀

傳遞至 RequestStateChange 方法之虛擬機器的最後一個要求或所需狀態，如果沒有任何狀態變更，則為 12 (不適用) 。 專案的實際狀態是由 EnabledState表示。 提供這個屬性來比較上次要求和目前啟用或停用的狀態。 此屬性繼承自 CIM_EnabledLogicalElement。

ResetCapability

資料類型： uint16

存取類型：唯讀

此屬性繼承自 CIM_ComputerSystem，而且一律會設定為 1 (Other) 。

角色

資料類型： 字串 陣列

存取類型：唯讀

字串陣列，描述系統在資訊技術環境中扮演的角色。 此屬性繼承自 CIM_System，而且一律會設定為 Null。

狀態

資料類型： 字串

存取類型：唯讀

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

StatusDescriptions

資料類型： 字串 陣列

存取類型：唯讀

限定詞： ArrayType (「Indexed」)

陣列，包含描述對應 OperationalStatus 陣列值的字串。 例如，如果 11 (In Service) 是指派給 OperationalStatus[0] 的值， 則 StatusDescriptions[0] 可能包含虛擬機器處理要求的原因說明。 此屬性繼承自 CIM_ManagedSystemElement。

TimeOfLastConfigurationChange

資料類型： datetime

存取類型：唯讀

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

TimeOfLastStateChange

資料類型： datetime

存取類型：唯讀

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

TransitioningToState

資料類型： uint16

存取類型：唯讀

指出實例正在轉換的目標狀態。 此屬性繼承自 CIM_EnabledLogicalElement，但不會使用。

備註

下圖顯示 EnabledState 值。

windows Server 2008 r2 的 enabledstate 值狀態圖

當 Msvm_ComputerSystem 類別的 屬性變更時，WMI 提供者會指出 描述變更的__InstanceModificationEvent 事件。 上一個狀態包含在 PreviousInstance 屬性中，而新狀態則包含在 TargetInstance 屬性中。 這個事件是非同步;在處理 __InstanceModificationEvent 事件時， TargetInstance 屬性可能不會反映目前的狀態。

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

範例

請參閱 查詢網路物件。

規格需求

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

另請參閱

CIM_ComputerSystem

__InstanceModificationEvent

CIM_ComputerSystem

Msvm_ComputerSystem (V1)

虛擬系統類別