Win32_Service 類別的 ChangeStartMode 方法, (遠端桌面服務)
ChangeStartModeWMI 類別方法會修改Win32_TerminalService的開始模式。
本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊,請參閱 呼叫方法。
語法
uint32 ChangeStartMode(
[in] string StartMode
);
參數
-
StartMode [in]
-
Windows 基底服務的啟動模式。
-
引導
-
作業系統載入器啟動的裝置驅動程式。 這個值只適用於驅動程式服務。
-
系統
-
作業系統初始化程式啟動的裝置驅動程式。 這個值只適用於驅動程式服務。
-
自動
-
服務控制管理員在系統啟動期間自動啟動的服務。
-
手動
-
當進程呼叫 StartService 方法時,服務控制管理員要啟動的服務。
-
禁用
-
無法再啟動的服務。
傳回值
傳回下列清單中所列的其中一個值,或任何其他值,以指出錯誤。 如需其他錯誤碼,請參閱 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
-
服務目前在系統中暫停。
範例
下列從 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\TerminalServices |
MOF |
|
DLL |
|