ChangeStartMode-Methode der Win32_Service-Klasse (CIMWin32 WMI-Anbieter)
Die WMI-KlassenmethodeChangeStartMode ändert den Startmodus eines Win32_Service.
In diesem Thema wird MOF-Syntax (Managed Object Format) verwendet. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Aufrufen einer Methode.
Syntax
uint32 ChangeStartMode(
[in] string StartMode = Auto Start
);
Parameter
-
StartMode [in]
-
Startmodus des Windows-Basisdiensts.
-
Startstart ("Start")
-
Gerätetreiber, der vom Betriebssystemladeprogramm gestartet wird. Dieses Wert ist nur für Treiberdienste gültig.
-
System ("System")
-
Gerätetreiber, der vom Initialisierungsprozess des Betriebssystems gestartet wird. Dieses Wert ist nur für Treiberdienste gültig.
-
Automatischer Start ("Automatisch")
-
Der Dienst soll während des Systemstarts automatisch vom Dienstkontroll-Manager gestartet werden.
-
Bedarfsstart ("Manuell")
-
Dienst, der vom Dienststeuerungs-Manager gestartet werden soll, wenn ein Prozess die StartService-Methode aufruft.
-
Deaktiviert ("Deaktiviert")
-
Dienst, der nicht mehr gestartet werden kann.
Rückgabewert
Gibt einen der in der folgenden Liste aufgeführten Werte oder einen anderen Wert zurück, der auf einen Fehler hinweist. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.
-
Erfolgreich
-
0
Die Anforderung wurde akzeptiert.
-
Nicht unterstützt
-
1
Die Anforderung wird nicht unterstützt.
-
Zugriff verweigert
-
2
Der Benutzer hatte nicht den erforderlichen Zugriff.
-
Abhängige Dienste, die ausgeführt werden
-
3
Der Dienst kann nicht beendet werden, da andere ausgeführte Dienste davon abhängig sind.
-
Ungültiges Dienststeuerelement
-
4
Der angeforderte Steuerungscode ist nicht gültig, oder es ist für den Dienst nicht akzeptabel.
-
Der Dienst kann die Steuerung nicht akzeptieren.
-
5
Der angeforderte Steuerungscode kann nicht an den Dienst gesendet werden, da der Status des Diensts (Win32_BaseService. State-Eigenschaft ) ist gleich 0, 1 oder 2.
-
Dienst nicht aktiv
-
6
Der Dienst wurde nicht gestartet.
-
Dienstanforderungstimeout
-
7
Der Dienst hat auf die Startanforderung nicht rechtzeitig reagiert.
-
Unbekannter Fehler
-
8
Unbekannter Fehler beim Starten des Diensts.
-
Pfad nicht gefunden
-
9
Der Verzeichnispfad zur ausführbaren Dienstdatei wurde nicht gefunden.
-
Dienst wird bereits ausgeführt
-
10
Der Dienst wird schon ausgeführt.
-
Dienstdatenbank gesperrt
-
11
Die Datenbank zum Hinzufügen eines neuen Diensts ist gesperrt.
-
Dienstabhängigkeit gelöscht
-
12
Eine Abhängigkeit, auf der sich dieser Dienst stützt, wurde aus dem System entfernt.
-
Dienstabhängigkeitsfehler
-
13
Der Dienst hat den Dienst nicht gefunden, der von einem abhängigen Dienst benötigt wird.
-
Dienst deaktiviert
-
14
Der Dienst wurde vom System deaktiviert.
-
Fehler bei der Dienstanmeldung
-
15
Der Dienst hat nicht die richtige Authentifizierung, um im System ausgeführt zu werden.
-
Dienst, der zum Löschen markiert ist
-
16
Dieser Dienst wird aus dem System entfernt.
-
Dienst ohne Thread
-
17
Der Dienst verfügt über keinen Ausführungsthread.
-
Statuskreisabhängigkeit
-
18
Der Dienst verfügt beim Start über zirkuläre Abhängigkeiten.
-
Doppelter Name des Status
-
19
Ein Dienst wird unter demselben Namen ausgeführt.
-
Status Ungültiger Name
-
20
Der Dienstname weist ungültige Zeichen auf.
-
Status Ungültiger Parameter
-
21
Ungültige Parameter wurden an den Dienst übergeben.
-
Status Ungültiges Dienstkonto
-
22
Das Konto, unter dem dieser Dienst ausgeführt wird, ist entweder ungültig oder verfügt nicht über die Berechtigungen zum Ausführen des Diensts.
-
Statusdienst vorhanden
-
23
Der Dienst ist in der Datenbank der im System verfügbaren Dienste vorhanden.
-
Dienst bereits angehalten
-
24
Der Dienst ist im System derzeitig angehalten.
-
Andere
-
25 4294967295
Beispiele
Das folgende Change StartMode of a Service PowerShell-Beispiel, das aus dem TechNet-Katalog abgerufen wird, ändert den Startmodus eines Diensts.
$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" }
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|