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	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

Classi del sistema operativo

Win32_service

Attività WMI: Servizi