Vorgehensweise: Installieren und Deinstallieren von Windows-Diensten

  • Artikel

Warnung

Diese Dokumentation gilt nicht für die neueste Version des Windows-Diensts. Die neuesten Inhalte zu Windows-Diensten mit BackgroundService und die Workerdienstvorlage finden Sie unter:

Wenn Sie einen Windows-Dienst mit dem .NET Framework entwickeln, können Sie Ihre Dienstanwendung schnell installieren, indem Sie das Befehlszeilendienstprogramm installutil.exe oder PowerShell verwenden. Entwickler, die einen Windows-Dienst veröffentlichen möchten, den Benutzer installieren und deinstallieren können, können das kostenlose WiX-Toolset oder kommerzielle Tools wie Advanced Installer, InstallShield und andere verwenden. Weitere Informationen finden Sie unter Erstellen eines Installationspakets (Windows-Desktop).

Warnung

Wenn Sie einen Dienst auf Ihrem Computer deinstallieren möchten, befolgen Sie die Schritte in diesem Artikel nicht. In diesem Fall finden Sie heraus, welches Programm oder Software-Paket den Dienst installiert hat. Wählen Sie dann in den Einstellungen Apps aus, um das Programm zu deinstallieren. Viele Dienste sind Bestandteile von Windows. Wenn Sie sie entfernen, können Sie die Instabilität des Systems verursachen.

Sie müssen zunächst ein Dienstinstallationsprogramm zu Ihrem Windows-Dienst hinzufügen, um die in diesem Artikel aufgeführten Schritte ausführen zu können. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen einer Windows-Dienstanwendung.

Sie können Windows-Dienstprojekte nicht durch Drücken von F5 direkt aus der Entwicklungsumgebung von Visual Studio ausführen. Bevor Sie das Projekt ausführen können, müssen Sie den Dienst im Projekt installieren.

Tipp

Sie können den Server-Explorer verwenden, um zu überprüfen, ob Sie Ihren Dienst installiert oder deinstalliert haben.

Installieren mithilfe des Hilfsprogramms installutil.exe

  1. Wählen Sie im Menü Start das Verzeichnis Visual Studio<Version> aus, und wählen Sie anschließend Developer-Eingabeaufforderung für VS <Version> aus.

    Daraufhin wird die Developer-Eingabeaufforderung für Visual Studio angezeigt.

  2. Greifen Sie auf das Verzeichnis zu, in dem sich die kompilierte ausführbare Datei des Projekts befindet.

  3. Führen Sie die InstallUtil.exe über die Eingabeaufforderung mit der ausführbaren Datei Ihres Projekts als Parameter aus:

    installutil <yourproject>.exe

    Wenn Sie die Developer-Eingabeaufforderung für Visual Studio verwenden, befindet sich InstallUtil.exe bereits im Systempfad. Andernfalls können Sie die Datei in den Pfad einfügen oder den vollqualifizierten Pfad zum Aufrufen verwenden. Dieses Tool wird mit dem .NET Framework in %WINDIR%\Microsoft.NET\Framework[64]<Frameworkversion> installiert.

    Zum Beispiel:

    • Für die 32-Bit-Version von .NET Framework 4 oder 4.5 und höher lautet der Standardpfad wie folgt, wenn Ihr Windows-Installationsverzeichnis C:\Windows ist: C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe.
    • Für die 64-Bit-Version von .NET Framework 4 oder 4.5 und höher lautet der Standardpfad wie folgt: C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe.

Deinstallieren mithilfe des Hilfsprogramms installutil.exe

  1. Wählen Sie im Menü Start das Verzeichnis Visual Studio<Version> aus, und wählen Sie anschließend Developer-Eingabeaufforderung für VS <Version> aus.

    Daraufhin wird die Developer-Eingabeaufforderung für Visual Studio angezeigt.

  2. Führen Sie die Datei InstallUtil.exe über die Eingabeaufforderung aus. Übergeben Sie die Ausgabe des Projekts als Parameter:

    installutil /u <yourproject>.exe

  3. Nachdem die ausführbare Datei für ein Dienst gelöscht wurde, kann der Dienst weiterhin in der Registrierung vorhanden sein. Verwenden Sie in diesem Fall den Befehl sc delete, um den Eintrag für den Dienst aus der Registrierung zu entfernen.

Installieren mithilfe von PowerShell

  1. Wählen Sie im Menü Start das Verzeichnis Windows PowerShell aus, und klicken Sie dann auf Windows PowerShell.

  2. Greifen Sie auf das Verzeichnis zu, in dem sich die kompilierte ausführbare Datei des Projekts befindet.

  3. Führen Sie das Cmdlet Neuer Dienst mit einem Dienstnamen und der Ausgabe des Projekts als Argumente aus:

    New-Service -Name "YourServiceName" -BinaryPathName <yourproject>.exe

Deinstallieren mithilfe von PowerShell

  1. Wählen Sie im Menü Start das Verzeichnis Windows PowerShell aus, und klicken Sie dann auf Windows PowerShell.

  2. Führen Sie das Cmdlet Dienst entfernen mit dem Namen Ihres Diensts als Argument aus:

    Remove-Service -Name "YourServiceName"

    Hinweis

    Sie müssen über PowerShell 6 oder höher verfügen, um dieses Cmdlet verwenden zu können. Weitere Informationen zum Aktualisieren von PowerShell finden Sie unter Installieren von PowerShell unter Windows.

  3. Nachdem die ausführbare Datei für ein Dienst gelöscht wurde, kann der Dienst weiterhin in der Registrierung vorhanden sein. Verwenden Sie in diesem Fall den Befehl sc delete, um den Eintrag für den Dienst aus der Registrierung zu entfernen.

    sc.exe delete "YourServiceName"

Siehe auch