Msvm_VirtualSystemSnapshotService 類別

發行項
08/19/2023

建立、套用和終結虛擬機器快照集的服務。

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

語法

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualSystemSnapshotService : CIM_VirtualSystemSnapshotService
{
  string   InstanceID;
  string   Caption = "Hyper-V Virtual System Snapshot Service";
  string   Description = "Service for creating, destroying, and applying virtual machine snapshots";
  string   ElementName;
  datetime InstallDate;
  string   Name = "vssnapsvc";
  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 = 2;
  string   OtherEnabledState;
  uint16   RequestedState = 12;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   AvailableRequestedStates[];
  uint16   TransitioningToState = 12;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_VirtualSystemSnapshotService";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   StartMode;
  boolean  Started = True;
};

成員

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

方法
屬性

方法

Msvm_VirtualSystemSnapshotService類別具有這些方法。

方法	描述
ApplySnapshot	將虛擬機器快照集套用至其建立來源的虛擬機器。
ClearSnapshotState	清除現有快照集的儲存狀態。
ConvertToReferencePoint	將現有的虛擬系統快照集轉換為參考點。快照集會刪除為副作用。只有復原快照集可以轉換成參考點。注意：Windows 10中新增了這個方法的支援。
CreateSnapshot	建立虛擬機器的快照集。
DestroySnapshot	終結現有的虛擬機器快照集。這個方法可能會造成副作用，終結相依于受影響快照集的其他快照集。
DestroySnapshotTree	移除虛擬機器的現有快照集及其所有子系。
RequestStateChange	要求元素的狀態變更。注意：Windows 10中新增了這個方法的支援。
StartService	不支援這個方法。
StopService	不支援這個方法。

屬性

Msvm_VirtualSystemSnapshotService類別具有這些屬性。

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，而且一律設定為「Hyper-V 虛擬系統快照集服務」。

CommunicationStatus

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

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

未知 (0)
無法使用 (1)
通訊正常 (2)
遺失通訊 (3)
沒有連絡人 (4)
DMTF 保留 (。。)
廠商保留 (0x8000。)

CreationClassName

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

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

描述

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

對物件的描述。此屬性繼承自 CIM_ManagedElement，而且一律設定為「建立、終結及套用虛擬機器快照集的服務」。

DetailedStatus

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

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

無法使用 (0)
沒有其他資訊 (1)
壓力 (2)
預測性失敗 (3)
無法復原的錯誤 (4)
錯誤 (5) 支援實體
DMTF 保留 (。。)
廠商保留 (0x8000。)

ElementName

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

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

EnabledDefault

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

系統管理員的元素啟用狀態的預設或啟動組態。此屬性繼承自 CIM_EnabledLogicalElement，且一律設定為 2 (Enabled) 。

值	意義
2	啟用

EnabledState

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

專案的啟用和停用狀態。它也可以指出這些要求狀態之間的轉換。此屬性繼承自 CIM_EnabledLogicalElement，且一律設定為 2 (Enabled) 。

值	意義
2	啟用

HealthState

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

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

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

InstallDate

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

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

InstanceID

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

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

名稱

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

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

OperatingStatus

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

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

未知 (0)
無法使用 (1)
服務 (2)
開始 (3)
停止 (4)
已停止 (5)
中止 (6)
休眠 (7)
已完成 (8)
移轉 (9)
Emigrating (10)
( 11)
快照集 (12)
關閉 (13)
在測試 (14)
轉換 (15)
在 Service (16)
DMTF 保留 (。。)
廠商保留 (0x8000。)

OperationalStatus

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

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

OtherEnabledState

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

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

PrimaryOwnerContact

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

如需有關如何聯機服務主要擁有者的任何資訊， (例如電話號碼、電子郵件地址等) 。此屬性繼承自 CIM_Service，而且一律設定為 Null。

PrimaryOwnerName

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

如果已定義服務，則為服務的主要擁有者名稱。主要擁有者是服務的初始支援連絡人。此屬性繼承自 CIM_Service，而且一律會設定為 Null。

PrimaryStatus

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

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

未知 (0)
確定 (1)
降級 (2)
錯誤 (3)
DMTF 保留 (。。)
廠商保留 (0x8000。)

RequestedState

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

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

值	意義
12	不適用。

Started

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

指出服務目前是否正在執行。此屬性繼承自 CIM_Service，而且一律會設定為 True。

StartMode

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

字串值，指出服務是否由系統、作業系統自動啟動，或只在要求時啟動。此屬性繼承自 CIM_Service，而且一律會設定為 Null。

狀態

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

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

StatusDescriptions

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

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

SystemCreationClassName

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

界定系統的建立類別名稱。此屬性繼承自 CIM_Service，而且一律會設定為「Msvm_ComputerSystem」。

SystemName

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

主控電腦系統的 NetBIOS 名稱。此屬性繼承自 CIM_Service。

TimeOfLastStateChange

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

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

TransitioningToState

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

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

值	意義
Unknown 0
Enabled 2
停用 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

共用方式為

Msvm_VirtualSystemSnapshotService 類別

語法

成員

方法

屬性

規格需求

意見反應

其他資源