Метод DefineSystem класса Msvm_VirtualSystemManagementService
Создает новый экземпляр виртуальной машины. Свойства, которые не указаны, будут заполнены значениями по умолчанию.
Синтаксис
uint32 DefineSystem(
[in] string SystemSettings,
[in] string ResourceSettings[],
[in] CIM_VirtualSystemSettingData REF ReferenceConfiguration,
[out] CIM_ComputerSystem REF ResultingSystem,
[out] CIM_ConcreteJob REF Job
);
Параметры
-
SystemSettings [in]
-
Тип: строка
Внедренный экземпляр класса Msvm_VirtualSystemSettingData , который используется для определения атрибутов создаваемой виртуальной машины. Это обязательный параметр.
-
ResourceSettings [in]
-
Тип: string[]
Ряд внедренных экземпляров Msvm_ResourceAllocationSettingData класса (или его производных классов). Вместе эти экземпляры описывают виртуальные ресурсы виртуальной машины. Набор устройств по умолчанию будет создан для виртуальной машины независимо от того, задан ли этот параметр. Например, процессор и память автоматически создаются и настраиваются со значениями по умолчанию.
-
ReferenceConfiguration [in]
-
Тип: CIM_VirtualSystemSettingData
Ссылка на экземпляр класса Msvm_VirtualSystemSettingData , который является объектом верхнего уровня эталонной конфигурации виртуальной машины. Эталонная конфигурация используется для дополнения конфигурации новой виртуальной машины, если параметры SystemSettings и ResourceSettings не предоставили соответствующих сведений.
-
ResultingSystem [out]
-
Тип: CIM_ComputerSystem
Ссылка на экземпляр класса CIM_ComputerSystem , представляющего только что созданную виртуальную машину.
-
Задание [out]
-
Тип: CIM_ConcreteJob
Если операция выполняется асинхронно, этот метод возвращает значение 4096, а этот параметр будет содержать ссылку на объект, производный от CIM_ConcreteJob.
Возвращаемое значение
Тип: uint32
Если этот метод выполняется синхронно, при успешном выполнении возвращается значение 0. Если этот метод выполняется асинхронно, он возвращает значение 4096 и выходной параметр Job можно использовать для отслеживания хода выполнения асинхронной операции. Любое другое возвращаемое значение указывает на ошибку.
-
Завершено без ошибок (0)
-
Не поддерживается (1)
-
Сбой (2)
-
Время ожидания (3)
-
Недопустимый параметр (4)
-
Зарезервировано DMTF (..)
-
Проверенные параметры метода — задание запущено (4096)
-
Метод Reserved (4097..32767)
-
Конкретный поставщик (32768..65535)
Комментарии
Доступ к классу Msvm_VirtualSystemManagementService может быть ограничен фильтрацией UAC. Дополнительные сведения см. в разделе Контроль учетных записей пользователей и WMI.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 8 [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2012 [только классические приложения] |
| Пространство имен |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|