Win32_Service 클래스의 ChangeStartMode 메서드(CIMWin32 WMI 공급자)
ChangeStartModeWMI 클래스 메서드는 Win32_Service 시작 모드를 수정합니다.
이 항목에서는 MOF(Managed Object Format) 구문을 사용합니다. 이 메서드를 사용하는 방법에 대한 자세한 내용은 메서드 호출을 참조 하세요.
구문
uint32 ChangeStartMode(
[in] string StartMode = Auto Start
);
매개 변수
-
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
서비스가 현재 시스템에서 일시 중지되었습니다.
-
기타
-
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 |
| 네임스페이스 |
Root\CIMV2 |
| MOF |
|
| DLL |
|