Класс 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	Применяет snapshot виртуальной машины к виртуальной машине, на основе которую она была создана.
ClearSnapshotState	Очищает состояние сохранения из существующего snapshot.
ConvertToReferencePoint	Преобразование существующей виртуальной системы snapshot в точку отсчета. Snapshot удаляется в качестве побочных эффектов. В эталонные точки можно преобразовать только моментальные снимки восстановления. Примечание: Поддержка этого метода была добавлена в Windows 10.
CreateSnapshot	Создает snapshot виртуальной машины.
DestroySnapshot	Уничтожение существующей виртуальной машины snapshot. Этот метод может в качестве побочных эффектов уничтожить другие моментальные снимки, зависящие от затронутого snapshot.
DestroySnapshotTree	Удаляет существующую snapshot и все ее дочерние элементы виртуальной машины.
RequestStateChange	Запрашивает изменение состояния для элемента . Примечание: Поддержка этого метода была добавлена в Windows 10.
StartService	Этот метод не поддерживается.
StopService	Этот метод не поддерживается.

Свойства

Класс Msvm_VirtualSystemSnapshotService имеет следующие свойства.

AvailableRequestedStates

Тип данных: массив uint16
Тип доступа: только для чтения

Указывает возможные значения параметра RequestedState метода RequestStateChange , используемого для инициации изменения состояния. Перечисленные значения будут подмножеством значений, содержащихся в свойстве RequestedStatesSupported связанного экземпляра CIM_EnabledLogicalElementCapabilities, где выбранные значения являются функцией текущего состояния объекта CIM_EnabledLogicalElement . Это свойство может быть не null , если реализация может объявить набор возможных значений как функцию текущего состояния. Это свойство будет иметь значение Null , если реализация не может определить набор возможных значений как функцию текущего состояния.

Это свойство наследуется от CIM_EnabledLogicalElement.

Включено (2)
Отключено (3)
Завершение работы (4)
Автономный (6)
Тест (7)
Отложить (8)
Заморажи ( 9)
Перезагрузка (10)
Сброс (11)
DmTF Reserved (.. )

Caption

Тип данных: string
Тип доступа: только для чтения

Краткое описание объекта. Это свойство наследуется от CIM_ManagedElement и всегда имеет значение "Служба моментальных снимков виртуальной системы Hyper-V".

CommunicationStatus

Тип данных: uint16
Тип доступа: только для чтения

Указывает на способность инструментирования взаимодействовать с базовым управляемым элементом. Значение NULL указывает, что это свойство не реализовано. Это свойство наследуется от CIM_ManagedSystemElement.

Неизвестно (0)
Недоступно (1)
Связь ОК (2)
Потерянная связь (3)
Нет контакта (4)
DmTF 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 Reserved (..)
Зарезервировано поставщиком (0x8000.. )

ElementName

Тип данных: string
Тип доступа: только для чтения

Отображаемое имя объекта. Это свойство наследуется от 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

Тип данных: 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)
Эмигрирование (10)
Иммигрирование (11)
Создание моментальных снимков (12)
Завершение работы (13)
В тесте (14)
Переход ( 15)
В службе (16)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (0x8000.. )

OperationalStatus

Тип данных: массив uint16
Тип доступа: только для чтения

Текущие состояния объекта. Это свойство наследуется от CIM_ManagedSystemElement, и каждому элементу массива всегда присваивается значение 2 (ОК).

OtherEnabledState

Тип данных: string
Тип доступа: только для чтения

Строка, описывающая состояние включенного или отключенного элемента, когда свойству EnabledState присвоено значение 1 (Other). Это свойство должно иметь значение Null , если EnabledState имеет любое значение, отличное от 1. Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение Null.

PrimaryOwnerContact

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen ( 256 )

Любые сведения о том, как получить доступ к основному владельцу службы (например, номер телефона, адрес электронной почты и т. д.). Это свойство наследуется от CIM_Service и всегда имеет значение Null.

PrimaryOwnerName

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: 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	Не применяется

Приступая к работе

Тип данных: boolean
Тип доступа: только для чтения

Указывает, запущена ли служба в данный момент. Это свойство наследуется от CIM_Service и всегда имеет значение True.

StartMode

Тип данных: string
Тип доступа: только для чтения
Квалификаторы: MaxLen ( 10 )

Строковое значение, указывающее, запускается ли служба автоматически системой, операционной системой или только по запросу. Это свойство наследуется от CIM_Service и всегда имеет значение Null.

Состояние

Тип данных: string
Тип доступа: только для чтения

Это свойство наследуется от CIM_ManagedSystemElement, но не используется.

Описания состояния

Тип данных: строковый массив
Тип доступа: только для чтения

Строки, описывающие различные значения массива 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
Enabled 2
Отключено 3
Отключение 4
Без изменений 5	Переход не выполняется.
В отключенном режиме 6
Тест 7
отложить; 8
Замораживание 9
Перезагрузка 10
Сброс 11
Неприменимо 12	Реализация не поддерживает представление текущих переходов.
Зарезервировано DMTF ..

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Пространство имен	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Поделиться через