Win32_Service 類別的 ChangeStartMode 方法 （CIMWin32 WMI 提供者）
ChangeStartModeWMI 類別方法會修改Win32_Service的啟動模式。
本主題使用Managed物件格式 （MOF） 語法。 如需使用此方法的詳細資訊，請參閱 呼叫方法。
語法
uint32 ChangeStartMode(
[in] string StartMode = Auto Start
);
參數
-
StartMode [in]
-
Windows 基底服務的啟動模式。
-
開機啟動 （“開機”）
-
由作業系統載入器啟動的裝置驅動程式。 此值僅適用於驅動程序服務。
-
系統 （“系統 ”）
-
由作業系統初始化程式啟動的裝置驅動程式。 此值僅適用於驅動程序服務。
-
自動啟動 （「自動」
-
服務控制管理員在系統啟動期間自動啟動的服務。
-
需求開始 （「手動」）
-
當行程呼叫 StartService 方法時，服務控制管理員所要啟動的服務 。
-
Disabled （“Disabled”）
-
無法再啟動的服務。
傳回值
傳回下列清單中所列的其中一個值，或任何其他值，以指出錯誤。 如需其他錯誤碼，請參閱 WMI 錯誤常數或 WbemErrorEnum。 如需一般 HRESULT 值，請參閱 系統錯誤碼。
-
「成功」
-
0
已接受要求。
-
不支援
-
1
不支援此要求。
-
拒絕存取
-
2
用戶沒有必要的存取權。
-
執行中的相依服務
-
3
無法停止服務，因為正在執行的其他服務相依於它。
-
服務控制件無效
-
4
要求的控制程式代碼無效，或服務無法接受。
-
服務無法接受控制件
-
5
要求的控制程式代碼無法傳送至服務，因為服務的狀態 （Win32_BaseService。State 屬性） 等於 0、1 或 2。
-
服務未使用中
-
6
服務尚未啟動。
-
服務要求逾時
-
7
服務未及時回應啟動要求。
-
未知失敗
-
8
啟動服務時發生未知的失敗。
-
找不到路徑
-
9
找不到服務可執行文件的目錄路徑。
-
服務已在執行中
-
10
服務已在執行中。
-
服務資料庫已鎖定
-
11
要加入新服務的資料庫已鎖定。
-
服務相依性已刪除
-
12
此服務所依賴的相依性已從系統中移除。
-
服務相依性失敗
-
13
服務找不到相依服務所需的服務。
-
服務已停用
-
14
服務已從系統停用。
-
服務登入失敗
-
15
服務沒有在系統上執行的正確驗證。
-
標示要刪除的服務
-
16
此服務正從系統中移除。
-
服務無線程
-
17
服務沒有執行線程。
-
狀態迴圈相依性
-
18
服務啟動時會有迴圈相依性。
-
狀態重複名稱
-
19
服務是以相同名稱執行。
-
狀態無效的名稱
-
20
服務名稱具有無效的字元。
-
狀態無效的參數
-
21
無效的參數已傳遞至服務。
-
狀態無效的服務帳戶
-
22
此服務執行的帳戶無效或缺少執行服務的許可權。
-
狀態服務存在
-
23
服務存在於系統可用的服務資料庫中。
-
服務已暫停
-
24
服務目前在系統中暫停。
-
其他
-
25 4294967295
範例
下列變更服務 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 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|