Msvm_VirtualSystemSnapshotService クラス

[アーティクル]
06/13/2023

仮想マシンのスナップショットを作成、適用、破棄するサービス。

次の構文は、簡略化されたマネージドオブジェクト形式 (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	このメソッドはサポートされていません。

Properties

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 予約済み (..)

Caption

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの簡単な説明。このプロパティは CIM_ManagedElementから継承され、常に "Hyper-V 仮想システムスナップショットサービス" に設定されます。

CommunicationStatus

データ型: uint16
アクセスの種類: 読み取り専用

基になるマネージド要素と通信するインストルメンテーションの機能を示します。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは、 CIM_ManagedSystemElementから継承されます。

不明 (0)
使用できません (1)
通信 OK (2)
失われた通信 (3)
連絡先なし (4)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

CreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: Key、 MaxLen ( 256 )

インスタンスの作成で使用されるクラスまたはサブクラスの名前。このプロパティは CIM_Serviceから継承され、常に "Msvm_VirtualSystemSnapshotService" に設定されます。

説明

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの説明。このプロパティは 、CIM_ManagedElementから継承され、常に "仮想マシンスナップショットを作成、破棄、適用するためのサービス" に設定されます。

DetailedStatus

データ型: uint16
アクセスの種類: 読み取り専用

PrimaryStatus プロパティに追加の状態の詳細を補完します。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは、 CIM_ManagedSystemElementから継承されます。

使用できません (0)
追加情報なし (1)
ストレス ( 2)
予測エラー (3)
回復できないエラー (4)
エラーのサポートエンティティ (5)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

ElementName

データ型: string
アクセスの種類: 読み取り専用

オブジェクトの表示名。このプロパティは、 CIM_ManagedElementから継承されます。

EnabledDefault

データ型: uint16
アクセスの種類: 読み取り専用

要素の有効な状態に対する管理者の既定の構成またはスタートアップ構成。このプロパティは CIM_EnabledLogicalElementから継承され、常に 2 (有効) に設定されます。

値	意味
2	Enabled

EnabledState

データ型: uint16
アクセスの種類: 読み取り専用

要素の有効および無効の状態。また、これらの要求された状態間の遷移を示すこともできます。このプロパティは CIM_EnabledLogicalElementから継承され、常に 2 (有効) に設定されます。

値	意味
2	Enabled

HealthState

データ型: uint16
アクセスの種類: 読み取り専用

要素の現在の正常性。この属性は、この要素の正常性を表しますが、必ずしもサブコンポーネントの正常性を表すわけではありません。指定できる値は 0 ~ 30 で、5 は要素が完全に正常であることを意味し、30 は要素が完全に非機能であることを意味します。このプロパティは CIM_ManagedSystemElementから継承され、常に 5 (OK) に設定されます。

値	説明
5	正常性状態は正常です。

InstallDate

データ型: datetime
アクセスの種類: 読み取り専用

仮想マシン構成が作成された日時。このプロパティは、 CIM_ManagedSystemElementから継承されます。

InstanceID

データ型: string
アクセスの種類: 読み取り専用
修飾子: キー

このクラスのインスタンスを一意に識別します。このプロパティは、 CIM_ManagedElementから継承されます。

名前

データ型: string
アクセスの種類: 読み取り専用
修飾子: Key、 MaxLen ( 256 )

オブジェクトが認識されるラベル。このプロパティは CIM_ManagedSystemElementから継承され、常に "vssnapsvc" に設定されます。

OperatingStatus

データ型: uint16
アクセスの種類: 読み取り専用

要素の操作条件の現在の状態情報を提供し、 EnabledState プロパティの値に関する詳細を提供するために使用できます。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは、 CIM_ManagedSystemElementから継承されます。

不明 (0)
使用できません (1)
サービス (2)
開始 (3)
停止中 (4)
停止 ( 5)
中止 ( 6)
休止中 (7)
完了 (8)
移行 (9)
Emigrating (10)
Immigrating (11)
スナップショット ( 12)
シャットダウン (13)
In Test (14)
移行中 (15)
In Service (16)
DMTF 予約済み (...)
Vendor Reserved (0x8000.. )

OperationalStatus

データ型: uint16 配列
アクセスの種類: 読み取り専用

オブジェクトの現在の状態。このプロパティは CIM_ManagedSystemElementから継承され、各配列要素は常に 2 (OK) に設定されます。

OtherEnabledState

データ型: string
アクセスの種類: 読み取り専用

EnabledState プロパティが 1 (Other) に設定されている場合の要素の有効または無効の状態を表す文字列。 EnabledState が 1 以外の値である場合、このプロパティは Null に設定する必要があります。このプロパティは CIM_EnabledLogicalElementから継承され、常に Null に設定 されます。

PrimaryOwnerContact

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen ( 256 )

サービスのプライマリ所有者に到達する方法に関する情報 (電話番号、メールアドレスなど)。このプロパティは CIM_Serviceから継承され、常に Null に設定 されます。

PrimaryOwnerName

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen ( 64 )

サービスのプライマリ所有者の名前 (定義されている場合)。プライマリ所有者は、サービスの最初のサポート連絡先です。このプロパティは CIM_Serviceから継承され、常に Null に設定 されます。

PrimaryStatus

データ型: uint16
アクセスの種類: 読み取り専用

高レベルの状態情報を提供します。このプロパティは、要素とそのサブコンポーネントの高レベルで詳細な正常性状態を提供するために 、DetailedStatus プロパティと組み合わせて使用する必要があります。 Null 値は、このプロパティが実装されていないことを示します。このプロパティは 、CIM_ManagedSystemElementから継承されます。

不明 (0)
OK (1)
機能低下 (2)
エラー (3)
DMTF 予約済み (..)
ベンダー予約 済み (0x8000.. )

RequestedState

データ型: uint16
アクセスの種類: 読み取り専用

要素に対して最後に要求された状態または目的の状態。要素の実際の状態は EnabledState で表されます。このプロパティは、要素の最後に要求された状態と現在の状態を比較するために提供されます。 CIM_EnabledLogicalElement クラスの特定のインスタンスが RequestedState プロパティをサポートしていない場合があります。これが発生した場合は、値 12 (該当なし) が使用されます。このプロパティは CIM_EnabledLogicalElementから継承され、常に 12 (適用できません) に設定されます。

値	意味
12	適用不可。

Started

データ型: boolean
アクセスの種類: 読み取り専用

サービスが現在実行されているかどうかを示します。このプロパティは CIM_Serviceから継承され、常に True に設定されます。

StartMode

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen ( 10 )

サービスがシステム、オペレーティングシステム、または要求時にのみ開始されるかどうかを示す文字列値。このプロパティは CIM_Serviceから継承され、常に Null に設定 されます。

状態

データ型: string
アクセスの種類: 読み取り専用

このプロパティは CIM_ManagedSystemElementから継承されますが、使用されません。

StatusDescriptions

データ型: string 配列
アクセスの種類: 読み取り専用

さまざまな OperationalStatus 配列値を記述する文字列。このプロパティは CIM_ManagedSystemElementから継承され、各配列要素は常に "サービスが正常に実行されています" に設定されます。

SystemCreationClassName

データ型: string
アクセスの種類: 読み取り専用
修飾子: Key、 MaxLen ( 256 )

スコープシステムの作成クラス名。このプロパティは CIM_Serviceから継承され、常に "Msvm_ComputerSystem" に設定されます。

Systemname

データ型: string
アクセスの種類: 読み取り専用
修飾子: Key、 MaxLen ( 256 )

ホストコンピューターシステムの NetBIOS 名。このプロパティは、 CIM_Serviceから継承されます。

TimeOfLastStateChange

データ型: datetime
アクセスの種類: 読み取り専用

要素の有効な状態が最後に変更された日時。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

TransitioningToState

データ型: uint16
アクセスの種類: 読み取り専用

インスタンスが遷移しているターゲットの状態を示します。このプロパティは、 CIM_EnabledLogicalElementから継承されます。

値	意味
Unknown 0
有効 2
Disabled 3
シャットダウン 4
変更なし 5	移行は進行中です。
オフライン 6
テスト 7
延期 8
休止 9
Reboot 10
リセット 11
該当なし 12	実装では、進行中の遷移の表現はサポートされていません。
DMTF 予約済み ..

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリのみ]
名前空間	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
[DLL]	Vmms.exe

次の方法で共有

Msvm_VirtualSystemSnapshotService クラス

構文

メンバー

メソッド

Properties

要件

フィードバック

その他のリソース