класс Msvm_VirtualSystemManagementService

Статья
06/13/2023

Представляет службу виртуализации, которая присутствует в одной хост-системе. Msvm_VirtualSystemManagementService используется для управления определением, изменением и удалением виртуальных машин. Он также содержит методы для выполнения операций с виртуальными машинами, таких как клонирование, создание моментальных снимков, а также импорт или экспорт виртуальных машин. Чтобы получить сведения об каждой виртуальной машине, используйте Msvm_ComputerSystem.

Следующий синтаксис представляет собой упрощенный код MOF и включает все унаследованные свойства.

Синтаксис

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_VirtualSystemManagementService : CIM_VirtualSystemManagementService
{
  string   InstanceID;
  string   Caption = "Virtual System Management Service";
  string   Description = "Service for creating, manipulating, and managing virtual machines";
  string   ElementName = "Hyper-V Virtual System Management Service";
  datetime InstallDate;
  string   Name = "vmms";
  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;
  string   SystemCreationClassName = "Msvm_ComputerSystem";
  string   SystemName;
  string   CreationClassName = "Msvm_VirtualSystemManagementService";
  string   PrimaryOwnerName;
  string   PrimaryOwnerContact;
  string   StartMode;
  boolean  Started = True;
};

Члены

Класс Msvm_VirtualSystemManagementService имеет следующие типы членов:

Методы
Свойства

Методы

Класс Msvm_VirtualSystemManagementService содержит следующие методы.

Метод	Описание
AddBootSourceSettings	Добавляет источники загрузки в конфигурацию виртуальной системы при применении к конфигурации виртуальной системы "состояние".
AddFeatureSettings	Добавляет параметры функций Ethernet в конфигурацию подключения Ethernet виртуальной машины.
AddFibreChannelChap	Добавляет параметры DH-CHAP в искусственный порт Fibre Channel на виртуальной машине.
AddGuestServiceSettings	Добавляет параметры гостевой службы в конфигурацию виртуальной системы. При применении к частям "текущей" конфигурации виртуальной системы в качестве побочных эффектов гостевые службы активной виртуальной системы могут быть изменены.
AddKvpItems	Добавляет пары "ключ-значение" в виртуальную машину.
AddResourceSettings	Добавляет ресурсы в конфигурацию виртуальной машины.
AddSystemComponentSettings	Добавляет универсальные параметры в конфигурацию виртуальной системы.
DefinePlannedSystem	Определяет запланированную виртуальную систему. Входные данные, которые не указаны полностью, могут быть заполнены значениями по умолчанию.
DefineSystem	Создает новое определение виртуальной машины.
DestroySystem	Удаляет существующее определение виртуальной машины.
ДиагностикаNetworkConnection	Диагностика сетевого подключения виртуальной машины в среде виртуализации сети Windows.
ExportSystemDefinition	Экспортирует виртуальную машину или snapshot виртуальной машины в файл.
FormatError	Возвращает форматированную строку сообщения об ошибке для указанного массива внедренных экземпляров Msvm_Error .
GenerateWwpn	Создает набор имен портов WWPN.
GetCurrentWwpnFromGenerator	Предоставляет возможность предварительного просмотра текущего имени WWPN без резерва WWPN.
GetDefinitionFileSummaryInformation	Возвращает сводные сведения о виртуальных машинах для указанных файлов определения виртуальных машин.
GetSizeOfSystemFiles	Извлекает общий размер системных файлов виртуальной машины.
GetSummaryInformation	Возвращает сводные сведения о виртуальной машине.
GetVirtualSystemThumbnailImage	Извлекает эскиз существующей виртуальной машины.
ImportSnapshotDefinitions	Выполняет поиск в указанной папке всех файлов определения snapshot, связанных с указанной запланированной компьютерной системой, и создает новый snapshot в запланированной компьютерной системе для каждого связанного файла определения в этом расположении.
ImportSystemDefinition	Создает новую запланированную компьютерную систему на основе указанного определения виртуальной машины.
ModifyDiskMergeSettings	Изменяет данные параметров слияния дисков.
ModifyFeatureSettings	Изменяет текущие параметры компонентов подключения Ethernet виртуальной машины.
ModifyGuestServiceSettings	Изменяет параметры гостевой службы. При применении к частям "текущей" конфигурации виртуальной системы в качестве побочных эффектов гостевые службы активной виртуальной системы могут быть изменены.
ModifyKvpItems	Изменяет существующие пары "ключ-значение" на виртуальной машине.
ModifyResourceSettings	Изменяет параметры виртуальных ресурсов.
ModifyServiceSettings	Изменяет данные параметров службы.
ModifySystemComponentSettings	Изменяет универсальные параметры системных компонентов.
ModifySystemSettings	Изменяет параметры виртуальной машины.
RealizePlannedSystem	Проверяет конфигурацию запланированной виртуальной машины и преобразует ее в реализованную виртуальную машину.
RemoveBootSourceSettings	Удаляет параметры виртуальных ресурсов из конфигурации виртуальной системы. При применении к частям "текущей" конфигурации виртуальной системы в качестве побочных эффектов ресурсы активной виртуальной системы могут быть удалены.
RemoveFeatureSettings	Удаляет параметры компонентов из подключения Ethernet виртуальной машины.
RemoveFibreChannelChap	Удаляет параметры DH-CHAP из искусственного порта Fibre Channel на виртуальной машине.
RemoveGuestServiceSettings	Удаляет параметры гостевой службы из конфигурации виртуальной системы. При применении к частям "текущей" конфигурации виртуальной системы в качестве побочных эффектов гостевые службы активной виртуальной системы могут быть изменены.
RemoveKvpItems	Удаляет существующие пары "ключ-значение" из виртуальной машины.
RemoveResourceSettings	Удаляет параметры виртуальных ресурсов из конфигурации виртуальной машины.
RemoveSystemComponentSettings	Удаляет универсальные параметры компонентов из конфигурации виртуальной системы.
RequestStateChange	Этот метод не поддерживается.
SetGuestNetworkAdapterConfiguration	Настраивает сетевые адаптеры в операционной системе на виртуальной машине.
SetInitialMachineConfigurationData	Задает исходные данные конфигурации виртуальной машины.
StartService	Этот метод не поддерживается.
StopService	Этот метод не поддерживается.
TestNetworkConnection	Проверяет сетевое подключение виртуальной машины в среде виртуализации сети Windows.
UpgradeSystemVersion	Обновляет виртуальную систему. При применении к параметрам системы "текущей" конфигурации виртуальной системы
ValidatePlannedSystem	Проверяет указанную запланированную систему.

Свойства

Класс Msvm_VirtualSystemManagementService имеет эти свойства.

AvailableRequestedStates

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

Указывает возможные значения для параметра RequestedState метода RequestStateChange . Это свойство наследуется от CIM_EnabledLogicalElement и всегда имеет значение Null.

Caption

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

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

CommunicationStatus

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

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

Неизвестно (0)
Недоступно (1)
Связь ОК (2)
Потерянная связь (3)
Нет контакта (4)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (0x8000.. )

CreationClassName

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

Имя класса или подкласса, используемого при создании экземпляра. Это свойство наследуется от CIM_Service и всегда имеет значение "Msvm_VirtualSystemManagementService".

Описание

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

Описание объекта. Это свойство наследуется от CIM_ManagedElement и всегда имеет значение "Служба для создания, управления виртуальными машинами и управления ими".

DetailedStatus

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

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

Недоступно (0)
Нет дополнительной информации (1)
Подчеркнуто (2)
Прогнозный сбой (3)
Невосстанавливаемая ошибка (4)
Ошибка поддержки сущности (5)
Зарезервировано DMTF (..)
Зарезервировано поставщиком (0x8000.. )

ElementName

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

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

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 и всегда имеет значение vmms.

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 ("Другое"). Это свойство должно иметь значение 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 и всегда имеет значение Null.

Требования

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

См. также раздел

CIM_VirtualSystemManagementService
CIM_VirtualSystemManagementService
Msvm_VirtualSystemManagementService (V1)
Классы управления виртуальной системой