класс Msvm_VirtualSystemManagementService
Представляет службу виртуализации, которая присутствует в одной хост-системе. 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.
-
Комментарии
Доступ к классу Msvm_VirtualSystemManagementService может быть ограничен фильтрацией UAC. Дополнительные сведения см. в разделе Контроль учетных записей и инструментарий WMI.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 8 [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2012 [только классические приложения] |
| Пространство имен |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|