Метод ChangeStartMode класса Win32_Service (поставщики WMI CIMWin32)

Статья
06/13/2023

Метод класса WMI ChangeStartMode изменяет режим запуска Win32_Service.

В этом разделе используется синтаксис MOF. Дополнительные сведения об использовании этого метода см. в разделе Вызов метода .

Синтаксис

uint32 ChangeStartMode(
  [in] string StartMode = Auto Start
);

Параметры

StartMode [in]: Режим запуска базовой службы Windows.
Начальная загрузка ("Загрузка"): Драйвер устройства, запущенный загрузчиком операционной системы. Это значение допустимо только для служб драйверов.
System ("System"): Драйвер устройства, запущенный процессом инициализации операционной системы. Это значение допустимо только для служб драйверов.
Автозапуск ("Автоматический"): Служба запускается автоматически диспетчером управления службами во время запуска системы.
Demand Start ("Manual"): Служба, запускаемая диспетчером управления службами, когда процесс вызывает метод StartService .
Disabled ("Disabled"): Служба, которая больше не может быть запущена.

Возвращаемое значение

Возвращает одно из значений, перечисленных в следующем списке, или любое другое значение, указывающее на ошибку. Дополнительные коды ошибок см. в разделе Константы ошибок WMI или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.

Успешно

Запрос принят.

Не поддерживается

Запрос не поддерживается.

доступ запрещен

У пользователя не было необходимого доступа.

Запущенные зависимые службы

Службу нельзя остановить, так как от нее зависят другие работающие службы.

Недопустимый элемент управления службой

Запрошенный управляющий код недопустим или неприемлем для данной службы.

Служба не может принимать управление

Запрошенный код элемента управления не может быть отправлен в службу, так как состояние службы (Win32_BaseService. Свойство State ) равно 0, 1 или 2.

Служба не активна

Служба не запущена.

Время ожидания запроса на обслуживание

Служба не ответила на запрос запуска за отведенное время.

Неизвестный сбой

Неизвестный сбой при запуске службы.

Путь не найден

Путь к каталогу к исполняемому файлу службы не найден.

Служба уже запущена

Служба уже запущена.

База данных службы заблокирована

База данных для добавления новой службы заблокирована.

Удалена зависимость службы

Зависимость, на основе которого используется эта служба, была удалена из системы.

Сбой зависимости службы

Этой службе не удалось найти службу, которая необходима зависимой службе.

Служба отключена

Эта служба была отключена в системе.

Сбой входа в службу

Эта служба не поддерживает проверку подлинности, необходимую для работы в системе.

Служба помечена для удаления

Эта служба удаляется из системы.

Поток без службы

Служба не имеет потока выполнения.

Циклическая зависимость состояния

Служба имеет циклические зависимости при запуске.

Повторяющееся имя состояния

Служба выполняется под тем же именем.

Недопустимое имя состояния

Имя службы содержит недопустимые символы.

Недопустимый параметр status

Службе переданы недопустимые параметры.

Состояние недопустимой учетной записи службы

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

Служба состояния существует

Служба существует в базе данных доступных в системе служб.

Служба уже приостановлена

Служба в данный момент приостановлена в системе.

Другое

25 4294967295

Примеры

Приведенный ниже параметр Change StartMode примера Service PowerShell, извлеченного из коллекции TechNet, изменяет режим запуска службы.

$wmi = get-wmiobject -class win32_service -namespace root\cimv2 -computername lisbon | 
where-object { $_.name -eq 'bits' } 
 
$rtn = $wmi.changestartmode("manual") 
if($rtn.returnvalue -eq 0) { "success" } 
ELSE 
  { " $($rtn.returnvalue) was reported" }

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

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

Классы операционной системы
Win32_Service
Задачи WMI: службы