ChangeStartMode-Methode der Win32_Service-Klasse (Remotedesktopdienste)
Die WMI-KlassemethodeChangeStartMode ändert den Startmodus eines Win32_TerminalService.
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
);
Parameter
-
StartMode [in]
-
Startmodus des Windows-Basisdiensts.
-
Booten
-
Der Gerätetreiber wurde vom Betriebssystemladeprogramm gestartet. Dieses Wert ist nur für Treiberdienste gültig.
-
System
-
Der Gerätetreiber wurde vom Initialisierungsprozess des Betriebssystems gestartet. Dieses Wert ist nur für Treiberdienste gültig.
-
Automatisch
-
Dienst, der automatisch vom Dienststeuerungs-Manager während des Systemstarts gestartet werden soll.
-
Manuell
-
Dienst, der vom Dienststeuerungs-Manager gestartet werden soll, wenn ein Prozess die StartService-Methode aufruft.
-
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, um einen Fehler anzugeben. Weitere Fehlercodes finden Sie unter WMI-Fehlerkonstanten oder WbemErrorEnum. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.
-
0
-
Die Anforderung wurde akzeptiert.
-
1
-
Die Anforderung wird nicht unterstützt.
-
2
-
Der Benutzer hatte nicht den erforderlichen Zugriff.
-
3
-
Der Dienst kann nicht beendet werden, da andere ausgeführte Dienste davon abhängig sind.
-
4
-
Der angeforderte Steuerungscode ist nicht gültig, oder es ist für den Dienst nicht akzeptabel.
-
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.
-
6
-
Der Dienst wurde nicht gestartet.
-
7
-
Der Dienst hat auf die Startanforderung nicht rechtzeitig reagiert.
-
8
-
Unbekannter Fehler beim Starten des Diensts.
-
9
-
Der Verzeichnispfad zur ausführbaren Datei des Diensts wurde nicht gefunden.
-
10
-
Der Dienst wird schon ausgeführt.
-
11
-
Die Datenbank zum Hinzufügen eines neuen Diensts ist gesperrt.
-
12
-
Eine Abhängigkeit, auf der sich dieser Dienst stützt, wurde aus dem System entfernt.
-
13
-
Der Dienst hat den Dienst nicht gefunden, der von einem abhängigen Dienst benötigt wird.
-
14
-
Der Dienst wurde vom System deaktiviert.
-
15
-
Der Dienst hat nicht die richtige Authentifizierung, um im System ausgeführt zu werden.
-
16
-
Dieser Dienst wird aus dem System entfernt.
-
17
-
Der Dienst verfügt über keinen Ausführungsthread.
-
18
-
Der Dienst verfügt beim Starten über zirkuläre Abhängigkeiten.
-
19
-
Ein Dienst wird unter demselben Namen ausgeführt.
-
20
-
Der Dienstname weist ungültige Zeichen auf.
-
21
-
Ungültige Parameter wurden an den Dienst übergeben.
-
22
-
Das Konto, unter dem dieser Dienst ausgeführt wird, ist entweder ungültig oder es fehlen die Berechtigungen zum Ausführen des Diensts.
-
23
-
Der Dienst ist in der Datenbank der im System verfügbaren Dienste vorhanden.
-
24
-
Der Dienst ist im System derzeitig angehalten.
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\TerminalServices |
| MOF |
|
| DLL |
|