다음을 통해 공유


Msvm_VirtualSystemSnapshotService 클래스

가상 머신의 스냅샷을 만들고, 적용하고, 삭제하는 서비스입니다.

다음 구문은 간소화된 MOF(Managed Object Format) 코드이며 상속된 모든 속성을 포함합니다.

구문

[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 연결된 instance RequestedStatesSupported 속성에 포함된 값의 하위 집합입니다. 여기서 선택한 값은 CIM_EnabledLogicalElement 개체의 현재 상태 함수입니다. 구현에서 가능한 값 집합을 현재 상태의 함수로 보급할 수 있는 경우 이 속성은 Null 이 아닐 수 있습니다. 구현에서 현재 상태의 함수로 가능한 값 집합을 확인할 수 없는 경우 이 속성은 Null 이 됩니다.

이 속성은 CIM_EnabledLogicalElement 상속됩니다.

사용 (2)

사용 안 함 (3)

종료 (4)

오프라인 (6)

테스트 (7)

연기 (8)

정지 (9)

다시 부팅 (10)

초기화 (11)

DMTF 예약 됨(.. )

캡션

데이터 형식: string

액세스 형식: 읽기 전용

개체에 대한 간단한 설명입니다. 이 속성은 CIM_ManagedElement 상속되며 항상 "Hyper-V 가상 시스템 스냅샷 서비스"로 설정됩니다.

CommunicationStatus

데이터 형식: uint16

액세스 형식: 읽기 전용

계측이 기본 관리되는 요소와 통신하는 기능을 나타냅니다. Null 값은 이 속성이 구현되지 않음을 나타냅니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

알 수 없음 (0)

사용할 수 없음 (1)

통신 확인 (2)

통신 끊김 (3)

연락처 없음 (4)

DMTF 예약 됨(..)

Vendor Reserved (0x8000.. )

CreationClassName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: Key, MaxLen ( 256 )

instance 만드는 데 사용되는 클래스 또는 하위 클래스의 이름입니다. 이 속성은 CIM_Service 상속되며 항상 "Msvm_VirtualSystemSnapshotService"로 설정됩니다.

설명

데이터 형식: 문자열

액세스 형식: 읽기 전용

개체에 대한 설명입니다. 이 속성은 CIM_ManagedElement 상속되며 항상 "가상 머신 스냅샷 만들기, 삭제 및 적용을 위한 서비스"로 설정됩니다.

DetailedStatus

데이터 형식: uint16

액세스 형식: 읽기 전용

PrimaryStatus 속성을 추가 상태 세부 정보로 보완합니다. Null 값은 이 속성이 구현되지 않음을 나타냅니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

사용할 수 없음 (0)

추가 정보 없음 (1)

스트레스 ( 2)

예측 실패 (3)

복구할 수 없는 오류 (4)

오류에서 엔터티 지원 (5)

DMTF 예약 됨(..)

Vendor Reserved (0x8000.. )

ElementName

데이터 형식: 문자열

액세스 형식: 읽기 전용

개체의 표시 이름입니다. 이 속성은 CIM_ManagedElement 상속됩니다.

EnabledDefault

데이터 형식: uint16

액세스 형식: 읽기 전용

요소의 사용 상태에 대한 관리자의 기본 또는 시작 구성입니다. 이 속성은 CIM_EnabledLogicalElement 상속되며 항상 2(사용)로 설정됩니다.

의미
2
사용

EnabledState

데이터 형식: uint16

액세스 형식: 읽기 전용

요소의 사용 및 사용 안 함 상태입니다. 또한 이러한 요청된 상태 간의 전환을 나타낼 수도 있습니다. 이 속성은 CIM_EnabledLogicalElement 상속되며 항상 2(사용)로 설정됩니다.

의미
2
사용

HealthState

데이터 형식: uint16

액세스 형식: 읽기 전용

요소의 현재 상태입니다. 이 특성은 이 요소의 상태를 나타내지만 반드시 하위 구성 요소의 상태를 나타내는 것은 아닙니다. 가능한 값은 0에서 30입니다. 여기서 5는 요소가 완전히 정상이고 30은 요소가 완전히 비기능적임을 의미합니다. 이 속성은 CIM_ManagedSystemElement 상속되며 항상 5(확인)로 설정됩니다.

의미
5
상태 상태 정상입니다.

InstallDate

데이터 형식: datetime

액세스 형식: 읽기 전용

가상 머신 구성을 만든 날짜 및 시간입니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

InstanceID

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: Key

이 클래스의 instance 고유하게 식별합니다. 이 속성은 CIM_ManagedElement 상속됩니다.

이름

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: Key, MaxLen ( 256 )

개체가 알려진 레이블입니다. 이 속성은 CIM_ManagedSystemElement 상속되며 항상 "vssnapsvc"로 설정됩니다.

OperatingStatus

데이터 형식: uint16

액세스 형식: 읽기 전용

요소의 작동 조건에 대한 현재 상태 정보를 제공하며 EnabledState 속성의 값과 관련하여 더 자세한 정보를 제공하는 데 사용할 수 있습니다. Null 값은 이 속성이 구현되지 않음을 나타냅니다. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

알 수 없음 (0)

사용할 수 없음 (1)

서비스 (2)

시작 (3)

중지 (4)

중지됨 (5)

중단됨 (6)

휴면 (7)

완료됨 (8)

마이그레이션 중(9)

이주 (10)

이민 중(11)

스냅샷( 12)

종료 중 (13)

테스트 중 (14)

전환 중(15)

In Service (16)

DMTF 예약됨 (..)

Vendor Reserved (0x8000.. )

OperationalStatus

데이터 형식: uint16 배열

액세스 형식: 읽기 전용

개체의 현재 상태입니다. 이 속성은 CIM_ManagedSystemElement 상속되며 각 배열 요소는 항상 2(확인)로 설정됩니다.

OtherEnabledState

데이터 형식: 문자열

액세스 형식: 읽기 전용

EnabledState 속성이 1(기타)로 설정된 경우 요소의 사용 또는 사용 안 함 상태를 설명하는 문자열입니다. 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 예약됨 (..)

Vendor Reserved (0x8000.. )

RequestedState

데이터 형식: uint16

액세스 형식: 읽기 전용

요소에 대해 마지막으로 요청되거나 원하는 상태입니다. 요소의 실제 상태는 EnabledState로 표시됩니다. 이 속성은 요소에 대해 마지막으로 요청된 상태와 현재 상태를 비교하기 위해 제공됩니다. CIM_EnabledLogicalElement 클래스의 특정 instanceRequestedState 속성을 지원하지 않을 수 있습니다. 이 경우 값 12(해당 없음)가 사용됩니다. 이 속성은 CIM_EnabledLogicalElement 상속되며 항상 12(해당 없음)로 설정됩니다.

의미
12
해당 사항 없음

시작됨

데이터 형식: boolean

액세스 형식: 읽기 전용

서비스가 현재 실행 중인지 여부를 나타냅니다. 이 속성은 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

액세스 형식: 읽기 전용

instance 전환 중인 대상 상태를 나타냅니다. 이 속성은 CIM_EnabledLogicalElement 상속됩니다.

의미
알 수 없음
0
Enabled
2
사용 안 함
3
종료
4
변경 내용 없음
5
전환이 진행 중이 아닙니다.
오프라인
6
Test
7
지연
8
정지
9
Reboot
10
Reset
11
해당 없음
12
구현은 진행 중인 전환을 나타내는 것을 지원하지 않습니다.
DMTF 예약됨
..

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버
Windows Server 2012 [데스크톱 앱만 해당]
네임스페이스
Root\Virtualization\V2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe