ServiceInstaller Klasse

Definition

public ref class ServiceInstaller : System::Configuration::Install::ComponentInstaller

public class ServiceInstaller : System.Configuration.Install.ComponentInstaller

type ServiceInstaller = class
    inherit ComponentInstaller

Public Class ServiceInstaller
Inherits ComponentInstaller

Vererbung

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceInstaller

Beispiele

Im folgenden Beispiel wird ein Projektinstallationsprogramm namens MyProjectInstallererstellt, das von Installererbt. Es wird davon ausgegangen, dass es eine ausführbare Dienstdatei gibt, die zwei Dienste enthält: "Hello-World Service 1" und "Hello-World Service 2". Innerhalb des Konstruktors für MyProjectInstaller (der vom Installationshilfsprogramm aufgerufen wird) ServiceInstaller werden Objekte für jeden dieser Dienste und ein ServiceProcessInstaller für die ausführbare Datei erstellt. Damit das Installationshilfsprogramm als gültiges Installationsprogramm erkennt MyProjectInstaller , wird das RunInstallerAttribute Attribut auf truefestgelegt.

Optionale Eigenschaften werden für das Prozessinstallationsprogramm und die Dienstinstallationsinstaller festgelegt, bevor die Installationsprogramme der Installers Auflistung hinzugefügt werden. Wenn das Installationshilfsprogramm auf zugreift MyProjectInstaller, werden die Objekte, die der Installers Auflistung über einen Aufruf von hinzugefügt wurden, InstallerCollection.Add nach und nach installiert. Während des Vorgangs verwaltet das Installationsprogramm Zustandsinformationen, die angeben, welche Objekte installiert wurden, sodass jedes nacheinander gesichert werden kann, wenn ein Installationsfehler auftritt.

Normalerweise würden Sie eine instance ihrer Projektinstallationsklasse nicht explizit erstellen. Sie würden sie erstellen und der Syntax das RunInstallerAttribute Attribut hinzufügen, aber es ist das Installationshilfsprogramm, das die -Klasse aufruft und daher instanziiert.

#using <System.dll>
#using <System.ServiceProcess.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Collections;
using namespace System::Configuration::Install;
using namespace System::ServiceProcess;
using namespace System::ComponentModel;

[RunInstaller(true)]
public ref class MyProjectInstaller : public Installer
{
private:
    ServiceInstaller^ serviceInstaller1;
    ServiceInstaller^ serviceInstaller2;
    ServiceProcessInstaller^ processInstaller;

public:
    MyProjectInstaller()
    {
        // Instantiate installers for process and services.
        processInstaller = gcnew ServiceProcessInstaller;
        serviceInstaller1 = gcnew ServiceInstaller;
        serviceInstaller2 = gcnew ServiceInstaller;

        // The services run under the system account.
        processInstaller->Account = ServiceAccount::LocalSystem;

        // The services are started manually.
        serviceInstaller1->StartType = ServiceStartMode::Manual;
        serviceInstaller2->StartType = ServiceStartMode::Manual;

        // ServiceName must equal those on ServiceBase derived classes.
        serviceInstaller1->ServiceName = "Hello-World Service 1";
        serviceInstaller2->ServiceName = "Hello-World Service 2";

        // Add installers to collection. Order is not important.
        Installers->Add( serviceInstaller1 );
        Installers->Add( serviceInstaller2 );
        Installers->Add( processInstaller );
    }

    static void Main()
    {
        Console::WriteLine("Usage: InstallUtil.exe [<service>.exe]");
    }
};

int main()
{
    MyProjectInstaller::Main();
}

using System;
using System.Collections;
using System.Configuration.Install;
using System.ServiceProcess;
using System.ComponentModel;

[RunInstaller(true)]
public class MyProjectInstaller : Installer
{
    private ServiceInstaller serviceInstaller1;
    private ServiceInstaller serviceInstaller2;
    private ServiceProcessInstaller processInstaller;

    public MyProjectInstaller()
    {
        // Instantiate installers for process and services.
        processInstaller = new ServiceProcessInstaller();
        serviceInstaller1 = new ServiceInstaller();
        serviceInstaller2 = new ServiceInstaller();

        // The services run under the system account.
        processInstaller.Account = ServiceAccount.LocalSystem;

        // The services are started manually.
        serviceInstaller1.StartType = ServiceStartMode.Manual;
        serviceInstaller2.StartType = ServiceStartMode.Manual;

        // ServiceName must equal those on ServiceBase derived classes.
        serviceInstaller1.ServiceName = "Hello-World Service 1";
        serviceInstaller2.ServiceName = "Hello-World Service 2";

        // Add installers to collection. Order is not important.
        Installers.Add(serviceInstaller1);
        Installers.Add(serviceInstaller2);
        Installers.Add(processInstaller);
    }

    public static void Main()
    {
        Console.WriteLine("Usage: InstallUtil.exe [<service>.exe]");
    }
}

Imports System.Collections
Imports System.Configuration.Install
Imports System.ServiceProcess
Imports System.ComponentModel

<RunInstallerAttribute(True)> _
Public Class MyProjectInstaller
    Inherits Installer
    Private serviceInstaller1 As ServiceInstaller
    Private serviceInstaller2 As ServiceInstaller
    Private processInstaller As ServiceProcessInstaller    
    
    Public Sub New()
        ' Instantiate installers for process and services.
        processInstaller = New ServiceProcessInstaller()
        serviceInstaller1 = New ServiceInstaller()
        serviceInstaller2 = New ServiceInstaller()
        
        ' The services will run under the system account.
        processInstaller.Account = ServiceAccount.LocalSystem
        
        ' The services will be started manually.
        serviceInstaller1.StartType = ServiceStartMode.Manual
        serviceInstaller2.StartType = ServiceStartMode.Manual
        
        ' ServiceName must equal those on ServiceBase derived classes.            
        serviceInstaller1.ServiceName = "Hello-World Service 1"
        serviceInstaller2.ServiceName = "Hello-World Service 2"
        
        ' Add installers to collection. Order is not important.
        Installers.Add(serviceInstaller1)
        Installers.Add(serviceInstaller2)
        Installers.Add(processInstaller)
    End Sub

    Public Shared Sub Main()
        Console.WriteLine("Usage: InstallUtil.exe [<service>.exe]")
    End Sub
End Class

Hinweise

Der ServiceInstaller funktioniert spezifisch für den Dienst, dem es zugeordnet ist. Es wird vom Installationshilfsprogramm verwendet, um dem Dienst zugeordnete Registrierungswerte in einen Unterschlüssel innerhalb des HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services Registrierungsschlüssels zu schreiben. Der Dienst wird durch seinen ServiceName in diesem Unterschlüssel identifiziert. Der Unterschlüssel enthält auch den Namen der ausführbaren Datei oder .dll, zu der der Dienst gehört.

Um einen Dienst zu installieren, erstellen Sie eine Projektinstallationsprogrammklasse, die von der Installer -Klasse erbt, und legen Sie das RunInstallerAttribute Attribut für die -Klasse auf fest true. Erstellen Sie innerhalb Ihres Projekts eine ServiceProcessInstaller instance pro Dienstanwendung und eine ServiceInstaller instance für jeden Dienst in der Anwendung. Legen Sie innerhalb des Klassenkonstruktors des Projektinstallationsprogramms die Installationseigenschaften für den Dienst mithilfe der ServiceProcessInstaller -Instanz und ServiceInstaller fest, und fügen Sie die Instanzen der Installers Auflistung hinzu.

Für alle Klassen, die von der Installer -Klasse abgeleitet werden, muss der Zustand der Installers Auflistung in den Install Methoden und Uninstall identisch sein. Sie können jedoch die Wartung der Auflistung für die Install Methoden und Uninstall vermeiden, wenn Sie der Installers Auflistung in Ihrem benutzerdefinierten Installationsklassenkonstruktor Installerinstanzen hinzufügen. Wenn das Installationshilfsprogramm aufgerufen wird, sucht es nach dem RunInstallerAttribute -Attribut. Wenn das Attribut lautet true, installiert das Hilfsprogramm alle Dienste, die der Auflistung hinzugefügt wurden, die Installers Ihrem Projektinstallationsprogramm zugeordnet waren. Wenn RunInstallerAttribute vorhanden ist oder nicht vorhanden ist false , ignoriert das Installationshilfsprogramm das Projektinstallationsprogramm.

Die ServiceProcessInstaller ihrer Projektinstallationsklasse zugeordnete installiert Informationen, die allen ServiceInstaller Instanzen im Projekt gemeinsam sind. Wenn dieser Dienst über etwas verfügt, das ihn von den anderen Diensten im Installationsprojekt trennt, werden diese dienstspezifischen Informationen durch diese Methode installiert.

Sie können andere Eigenschaften entweder vor oder nach dem ServiceInstaller Hinzufügen zur Installers Auflistung Ihres Projektinstallationsprogramms ändern. Beispielsweise kann ein Dienst so festgelegt werden, dass StartType der Dienst automatisch beim Neustart gestartet wird, oder ein Benutzer muss den Dienst manuell starten.

Normalerweise rufen Sie die Methoden nicht in Ihrem Code auf ServiceInstaller . Sie werden im Allgemeinen nur vom Installationshilfsprogramm aufgerufen. Das Installationshilfsprogramm ruft während des Installationsvorgangs automatisch die ServiceProcessInstaller.Install Methoden und ServiceInstaller.Install auf. Bei Bedarf werden Fehler durch Aufrufen Rollback (oder ServiceInstaller.Rollback) für alle zuvor installierten Komponenten gesichert.

Das Installationshilfsprogramm ruft auf Uninstall , um das -Objekt zu entfernen.

Die Installationsroutine einer Anwendung verwaltet automatisch Informationen zu den bereits installierten Komponenten mithilfe des -Installationsprogramms des Installer.ContextProjekts. Diese Zustandsinformationen werden kontinuierlich als ServiceProcessInstaller instance aktualisiert, und jede ServiceInstaller instance wird vom Hilfsprogramm installiert. Es ist in der Regel nicht erforderlich, dass Ihr Code Zustandsinformationen explizit ändert.

Wenn die Installation ausgeführt wird, wird automatisch ein EventLogInstaller erstellt, um die Ereignisprotokollquelle zu installieren, die der abgeleiteten ServiceBase Klasse zugeordnet ist. Die Log -Eigenschaft für diese Quelle wird vom ServiceInstaller Konstruktor auf das Anwendungsprotokoll des Computers festgelegt. Wenn Sie den ServiceName von ServiceInstaller festlegen (der mit dem ServiceBase.ServiceName des Diensts identisch sein sollte), wird automatisch Source auf den gleichen Wert festgelegt. Bei einem Installationsfehler wird für die Installation der Quelle ein Rollback zusammen mit zuvor installierten Diensten ausgeführt.

Die Uninstall -Methode versucht, den Dienst zu beenden, wenn er ausgeführt wird. Unabhängig davon, ob dies erfolgreich ist, Uninstall werden die von vorgenommenen Änderungen rückgängig gemacht Install. Wenn eine neue Quelle für die Ereignisprotokollierung erstellt wurde, wird die Quelle gelöscht.

Konstruktoren

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• ServiceName
• ServiceProcessInstaller
• ServiceBase
• EventLog