Erstellung eines Windows-Dienstes mit "Sc.exe"

Sie können das SC-Tool (Sc.exe), das im Resource Kit enthalten ist, zur Remote-Erstellung und zum Remote-Start eines Dienstes aus der Befehlszeile verwenden.

Sie können zwar auch die Tools "Netsvc.exe" und "Instsrv.exe" dazu verwenden, einen Dienst auf einem Remotecomputer zu starten, mit diesen Tools ist die Remote-Erstellung eines Dienstes jedoch nicht möglich.

Hinweis: Das Tool "Srvinstw.exe" mit grafischer Benutzeroberfläche wird zur Erstellung von Remotediensten verwendet. "Srvinstw.exe" ist kein Befehlszeilenprogramm.

Sie können "Sc.exe" bei der Entwicklung von Diensten für Windows verwenden. Das im Resource Kit enthaltene Tool "Sc.exe" implementiert Aufrufe an alle Windows-API-Funktionen zur Dienststeuerung (API = Application Programming Interface). Sie können die Parameter für diese Funktionen durch entsprechende Angaben in der Befehlszeile setzen. "Sc.exe" zeigt auch den Dienststatus an und ermittelt die Werte, die in den Statusstrukturfeldern gespeichert sind. Das Tool ermöglicht es Ihnen außerdem, den Namen eines Remotecomputers anzugeben, d. h. Sie können die Dienst-API-Funktionen aufrufen oder die Dienststatusstrukturen auf dem Remotecomputer anzeigen.

Mit "Sc.exe" können Sie außerdem beliebige API-Funktionen zur Dienststeuerung aufrufen und alle Parameter von der Befehlszeile aus ändern. Der Vorteil besteht darin, dass so die Dienstinformationen in der Registrierung und der Datenbank des Dienststeuerungs-Managers bequem erstellt und konfiguriert werden können. Sie müssen den Dienst nicht konfigurieren, indem Sie manuell Einträge in der Registrierung ändern und den Computer dann neu starten, um den Dienststeuerungs-Manager zur Aktualisierung seiner Datenbank zu zwingen.

"Sc.exe" verwendet die folgende Syntax:

Syntax1 (verwenden Sie Syntax1 zum Ausführen von "Sc.exe") Syntax2 (Verwenden Sie Syntax2 zur Anzeige von Hilfeinformationen, außer für den Befehl query)

Parameter

• Servername
  Optional. Gibt den Namen des Servers an, wenn Sie die Befehle auf einem Remotecomputer ausführen möchten. Der Name muss mit zwei umgekehrten Schrägstrichen (\) anfangen, z. B. \\myserver). Geben Sie diesen Parameter nicht an, wenn Sie "Sc.exe" auf dem lokalen Computer ausführen.
• Command
  Legt den Befehl sc fest. Beachten Sie, dass viele der sc-Befehle Administratorrechte auf dem angegebenen Computer voraussetzen. "Sc.exe" unterstützt die folgenden Befehle:
  Config
  Ändert die Konfiguration eines Dienstes (permanent).
  
  Continue
  Sendet eine Continue-Steuerungsanforderung (Fortsetzen) an einen Dienst.
  
  Control
  Sendet einen Steuerungsbefehl an einen Dienst.
  
  Create
  Erstellt einen Dienst (fügt ihn in der Registrierung hinzu).
  
  Delete
  Löscht einen Dienst (aus der Registrierung).
  
  EnumDepend
  Listet Dienstabhängigkeiten auf.
  
  GetDisplayName
  Ruft den Anzeigenamen für einen Dienst ab.
  
  GetKeyName
  Ruft den Dienstschlüsselnamen für einen Dienst ab.
  
  Interrogate
  Sendet eine Interrogate-Steuerungsanforderung (Abfragen) an einen Dienst.
  
  Pause
  Sendet eine Pause-Steuerungsanforderung (Anhalten) an einen Dienst.
  
  qc
  Fragt die Konfiguration für den Dienst ab. Weitere Informationen finden Sie in den Referenzinformationen unter "SC QC".
  
  Query
  Fragt den Status eines Dienstes ab oder listet den Status der Diensttypen auf. Weitere Informationen finden Sie in den Referenzinformationen unter "SC QUERY".
  
  Start
  Startet einen Dienst.
  
  Stop
  Sendet eine Stop-Anforderung an einen Dienst.
• Servicename
  Gibt den Namen des Dienstschlüssels in der Registrierung an. Beachten Sie, dass dieser von dem Anzeigenamen abweicht, den Sie über net start und die Option Dienste in der Systemsteuerung sehen. "Sc.exe" verwendet den Dienstschlüsselnamen als primäre Kennung für den Dienst.
• Optionname
  Über die Parameter "Optionname" und "Optionvalue" können Sie Namen und Werte für optionale Befehlsparameter angeben. Beachten Sie, dass zwischen dem Parameter "Optionname" und dem Gleichheitszeichen kein Leerzeichen steht. Sie können keinen, einen oder mehrere Namen-/Wertepaare für optionale Parameter angeben.
• Optionvalue
  Gibt den Wert für den durch "Optionname" bezeichneten Parameter an. Der Bereich der zulässigen Werte ist häufig pro Optionname-Parameter eingeschränkt. Eine Liste der verfügbaren Werte erhalten Sie über die Hilfeinformationen zu den einzelnen Befehlen.

Viele der Befehle erfordern Administratorberechtigungen. Stellen Sie sicher, dass Sie Administrator für den Computer sind, auf dem die Entwicklungsaufgaben durchgeführt werden.

Der Befehl sc create erzeugt einen Eintrag für den Dienst in der Registrierung und in der Datenbank des Dienststeuerungs-Managers.

Syntax

Parameter

• Servername
  Optional. Gibt den Namen des Servers an, wenn Sie die Befehle auf einem Remotecomputer ausführen möchten. Der Name muss mit zwei umgekehrten Schrägstrichen (\) anfangen, z. B. \\myserver). Geben Sie diesen Parameter nicht an, wenn Sie "Sc.exe" auf dem lokalen Computer ausführen.
• Servicename
  Gibt den Namen des Dienstschlüssels in der Registrierung an. Beachten Sie, dass dieser von dem Anzeigenamen abweicht, den Sie über net start und die Option "Dienste" in der Systemsteuerung sehen. "Sc.exe" verwendet den Dienstschlüsselnamen als primäre Kennung für den Dienst.
• Optionname
  Über die Parameter "Optionname" und "Optionvalue" können Sie Namen und Werte für optionale Parameter angeben. Beachten Sie, dass zwischen dem Parameter "Optionname" und dem Gleichheitszeichen kein Leerzeichen steht. Sie können keinen, einen oder mehrere Namen-/Wertepaare für optionale Parameter angeben. Der Befehl sc query unterstützt die folgenden Werte: OptionnameOptionvalue
  type=own, share, interact, kernel, filesys
  Typ des zu erstellenden Dienstes. Zu den möglichen Werten gehören von Treibern verwendete Typen.
  (Standard = share)
  
  start=boot, system, auto, demand, disabled
  Starttyp für den Dienst. Zu den möglichen Werten gehören von Treibern verwendete Typen.
  (Standard = demand)
  
  error=normal, severe, critical, ignore
  Schweregrad des Fehlers, wenn der Dienst beim Booten nicht gestartet wird.
  (Standard = normal)
  
  binPath=(string)
  Pfadname zur Binärdatei des Dienstes. Es gibt keinen Standardwert für diesen Parameter. Diese Zeichenfolge muss angegeben werden.
  
  group=(string)
  Name der Gruppe, deren Mitglied der betreffende Dienst ist. Die Liste der Gruppen ist in der Registrierung unter "ServiceGroupOrder" gespeichert.
  (Standard = nichts)
  
  tag=(string)
  Wenn diese Zeichenfolge auf "yes" gesetzt ist, erhält "Sc.exe" eine Tag-ID vom CreateService-Aufruf. "Sc.exe" zeigt den Tag jedoch nicht an.
  (Standard = nichts)
  
  depend=(durch Leerzeichen getrennte Zeichenfolge)
  Namen von Diensten oder Gruppen, die vor diesem Dienst gestartet werden müssen.
  
  obj=(Zeichenfolge)
  Name des Kontos, unter dem der Dienst läuft. Für Treiber ist dies der Windows-Treiberobjektname.
  (Standard = LocalSystem)
  
  DisplayName=(Zeichenfolge)
  Zeichenfolge, die von Benutzeroberflächenprogrammen zur Identifizierung des Dienstes genutzt werden kann.
  
  password=(Zeichenfolge)
  Kennwortzeichenfolge. Erforderlich, wenn ein anderes Konto als "LocalSystem" verwendet wird.

Optionvalue
Gibt den Wert für den durch "Optionname" bezeichneten Parameter an. Eine Liste der unterstützten Werte finden Sie in den Referenzinformationen zu "Optionname". Bei Eingabe einer Zeichenfolge bedeutet die Verwendung von leeren Anführungszeichen, dass eine leere Zeichenfolge übergeben wird. Beachten Sie das Leerzeichen zwischen OptionValue und dem Gleichheitszeichen.

Hinweis: Der Befehl sc create führt die Operationen der API-Funktion "CreateService" durch.

Das folgende Beispiel erzeugt einen Registrierungseintrag für den Dienst namens "NewService" auf dem Computer namens \\Remotecomputer: Hinweis: In Windows 2000, Windows XP, Windows Server 2003, Windows Vista und Windows Server 2008 ist der Wert für "binpath" unter "C:\Windows\System32\Newserv.exe" gespeichert.

Dieser Dienst wird standardmäßig als WIN32_SHARE_PROCESS mit dem Starttyp SERVICE_DEMAND_START erstellt. Er hat keine Abhängigkeiten und wird im LocalSystem-Sicherheitskontext ausgeführt.

Das folgende Beispiel erzeugt den Dienst auf dem lokalen Computer als automatisch startenden Dienst, der in einem eigenen Prozess ausgeführt wird. Er hat Abhängigkeiten von der TDI-Gruppe und vom NetBIOS-Dienst. Beachten Sie, dass Sie die Liste der durch Leerzeichen voneinander getrennten Abhängigkeiten in Anführungszeichen einschließen müssen. Hinweis: In Windows 2000, Windows XP, Windows Server 2003, Windows Vista und Windows Server 2008 ist der Wert für "binpath" unter "C:\Windows\System32\Newserv.exe" gespeichert.

Weitere Informationen zu dem Tool "Sc.exe" finden Sie im Dokument "Sc-dev.txt" im Resource Kit. Dieses Dokument enthält eine detailliertere Beschreibung von "Sc.exe".