Win32_Service 类的 ChangeStartMode 方法 (CIMWin32 WMI 提供程序)
ChangeStartModeWMI 类方法修改Win32_Service的启动模式。
本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息，请参阅 调用方法。
语法
uint32 ChangeStartMode(
[in] string StartMode = Auto Start
);
参数
-
StartMode [in]
-
Windows 基本服务的启动模式。
-
启动 (“启动”)
-
操作系统加载程序启动的设备驱动程序。 此值只对驱动程序服务有效。
-
系统 (“系统”)
-
由操作系统初始化过程启动的设备驱动程序。 此值只对驱动程序服务有效。
-
自动启动 (“自动”)
-
服务将在系统启动期间由服务控制管理器自动启动。
-
需求启动 (“手动”)
-
当进程调用 StartService 方法时由服务控制管理器启动的服务。
-
disabled (“Disabled”)
-
无法再启动的服务。
返回值
返回以下列表中列出的值之一或指示错误的任何其他值。 有关其他错误代码，请参阅 WMI 错误常量 或 WbemErrorEnum。 有关常规 HRESULT 值，请参阅 系统错误代码。
-
Success
-
0
已接受该请求。
-
不支持
-
1
不支持该请求。
-
拒绝访问
-
2
用户没有必要的访问权限。
-
正在运行的依赖服务
-
3
由于其他正在运行的服务依赖于该服务，不能停止该服务。
-
无效的服务控制
-
4
请求的控制代码无效或服务无法接受该控制代码。
-
服务无法接受控制
-
5
无法将请求的控制代码发送到服务，因为服务的状态 (Win32_BaseService。状态 属性) 等于 0、1 或 2。
-
服务未处于活动状态
-
6
该服务尚未启动。
-
服务请求超时
-
7
该服务未及时响应启动请求。
-
未知失败
-
8
启动服务时出现未知失败。
-
找不到路径
-
9
找不到服务可执行文件的目录路径。
-
服务已在运行
-
10
服务已在运行。
-
服务数据库已锁定
-
11
要添加新服务的数据库已锁定。
-
已删除服务依赖项
-
12
此服务依赖的依赖项已从系统中删除。
-
服务依赖项失败
-
13
该服务无法从依赖的服务中找到所需的服务。
-
服务已禁用
-
14
已从系统禁用该服务。
-
服务登录失败
-
15
服务没有在该系统上运行所需的正确身份验证。
-
标记为要删除的服务
-
16
正在从系统中删除此服务。
-
服务无线程
-
17
服务没有执行线程。
-
状态循环依赖项
-
18
服务启动时具有循环依赖项。
-
状态重复名称
-
19
服务以同一名称运行。
-
状态名称无效
-
20
服务名称包含无效字符。
-
状态无效参数
-
21
已将无效参数传递给服务。
-
服务帐户状态无效
-
22
运行此服务的帐户无效或缺少运行服务的权限。
-
状态服务存在
-
23
系统的服务数据库中已存在该服务。
-
服务已暂停
-
24
该服务目前在系统中已暂停。
-
其他
-
25 4294967295
示例
从 TechNet 库拉取的服务 PowerShell 示例 的以下更改 StartMode 更改服务的启动模式。
$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 |
|
| DLL |
|