Metodo ChangeStartMode della classe Win32_Service (provider WMI CIMWin32)
Il metodo della classe WMI ChangeStartModemodifica la modalità di avvio di un Win32_Service.
In questo argomento viene utilizzata la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.
Sintassi
uint32 ChangeStartMode(
[in] string StartMode = Auto Start
);
Parametri
-
StartMode [in]
-
Modalità di avvio del servizio di base di Windows.
-
Avvio di avvio ("Avvio")
-
Driver di dispositivo avviato dal caricatore del sistema operativo. Questo valore è valido solo per i servizi del driver.
-
Sistema ("Sistema")
-
Driver di dispositivo avviato dal processo di inizializzazione del sistema operativo. Questo valore è valido solo per i servizi del driver.
-
Avvio automatico ("automatico")
-
Servizio da avviare automaticamente da Gestione controllo servizi durante l'avvio del sistema.
-
Inizio richiesta ("Manuale")
-
Servizio da avviare dal gestore di controllo del servizio quando un processo chiama il metodo StartService.
-
Disabilitato ("Disabilitato ")
-
Servizio che non può più essere avviato.
Valore restituito
Restituisce uno dei valori elencati nell'elenco seguente o qualsiasi altro valore per indicare un errore. Per altri codici di errore, vedere Costanti di errore WMI o WbemErrorEnum. Per i valori HRESULT generali, vedere Codici di errore di sistema.
-
Success
-
0
La richiesta è stata accettata.
-
Non supportato
-
1
La richiesta non è supportata.
-
Accesso negato
-
2
L'utente non ha ottenuto l'accesso necessario.
-
Servizi dipendenti in esecuzione
-
3
Impossibile arrestare il servizio perché altri servizi in esecuzione dipendono dal servizio.
-
Controllo del servizio non valido
-
4
Il codice di controllo richiesto non è valido o non è accettabile per il servizio.
-
Il servizio non può accettare il controllo
-
5
Impossibile inviare il codice di controllo richiesto al servizio perché lo stato del servizio (Win32_BaseService.Proprietà state ) è uguale a 0, 1 o 2.
-
Servizio non attivo
-
6
Il servizio non è stato avviato.
-
Timeout richiesta di servizio
-
7
Il servizio non ha risposto in tempo utile alla richiesta di avvio.
-
Errore sconosciuto
-
8
Errore sconosciuto durante l'avvio del servizio.
-
Percorso non trovato
-
9
Impossibile trovare il percorso della directory del file eseguibile del servizio.
-
Servizio già in esecuzione
-
10
Il servizio è già in esecuzione.
-
Database del servizio bloccato
-
11
Il database a cui aggiungere il nuovo servizio è bloccato.
-
Dipendenza del servizio eliminata
-
12
Una dipendenza da cui si basa questo servizio è stata rimossa dal sistema.
-
Errore di dipendenza del servizio
-
13
Impossibile trovare un servizio dipendente necessario.
-
Servizio disabilitato
-
14
Il servizio è stato disabilitato dal sistema.
-
Accesso al servizio non riuscito
-
15
Il servizio non dispone delle credenziali di autenticazione corrette per l'esecuzione nel sistema.
-
Servizio contrassegnato per l'eliminazione
-
16
Questo servizio viene rimosso dal sistema.
-
Nessun thread del servizio
-
17
Il servizio non ha thread di esecuzione.
-
Dipendenza circolare dello stato
-
18
Il servizio ha dipendenze circolari all'avvio.
-
Nome duplicato stato
-
19
Un servizio viene eseguito con lo stesso nome.
-
Nome non valido per lo stato
-
20
Il nome del servizio ha caratteri non validi.
-
Parametro status non valido
-
21
I parametri non validi sono stati passati al servizio.
-
Stato Account del servizio non valido
-
22
L'account con cui viene eseguito il servizio non è valido o non dispone delle autorizzazioni per l'esecuzione del servizio.
-
Status Service Exists
-
23
Il servizio esiste già nel database dei servizi disponibili dal sistema.
-
Servizio già sospeso
-
24
Il servizio è attualmente sospeso nel sistema.
-
Altri
-
25 4294967295
Esempi
Nell'esempio Change StartMode di un servizio PowerShell seguente viene modificata la modalità di avvio di un servizio.
$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" }
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|