ServiceInstaller クラス

定義

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

継承

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceInstaller

例

次の例では、 からInstaller継承する という名前MyProjectInstallerのプロジェクト インストーラーを作成します。 "Hello-World Service 1" と "Hello-World Service 2" の 2 つのサービスを含むサービス実行可能ファイルがあることを前提としています。 (インストール ユーティリティによって呼び出される) ServiceInstaller のMyProjectInstallerコンストラクター内で、これらのサービスごとに オブジェクトが作成されServiceProcessInstaller、実行可能ファイルに 対して が作成されます。 インストール ユーティリティが有効なインストーラーとして認識 MyProjectInstaller するには、 属性が RunInstallerAttribute に true設定されます。

オプションのプロパティは、インストーラーがコレクションに追加される前に、プロセス インストーラーとサービス インストーラーで Installers 設定されます。 インストール ユーティリティが にアクセスMyProjectInstallerすると、 の呼び出しInstallerCollection.AddによってコレクションにInstallers追加されたオブジェクトが順番にインストールされます。 このプロセス中、インストーラーは、インストールされているオブジェクトを示す状態情報を保持するため、インストールエラーが発生した場合は、それぞれを順番にバックアウトできます。

通常は、プロジェクト インストーラー クラスのインスタンスを明示的に作成しません。 これを作成し、 属性を RunInstallerAttribute 構文に追加しますが、 クラスを実際に呼び出してインスタンス化するのはインストール ユーティリティです。

#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

注釈

は ServiceInstaller 、関連付けられているサービスに固有の機能を実行します。 これは、サービスに関連付けられているレジストリ値を、HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services レジストリ キー内のサブキーに書き込む場合に、インストール ユーティリティによって使用されます。 サービスは、このサブキー内の ServiceName によって識別されます。 サブキーには、サービスが属する実行可能ファイルまたは.dllの名前も含まれます。

サービスをインストールするには、 クラスから継承するプロジェクト インストーラー クラスを Installer 作成し、 クラスの 属性を RunInstallerAttribute に true設定します。 プロジェクト内で、サービス アプリケーションごとに 1 つの ServiceProcessInstaller インスタンスを作成し、アプリケーション内のサービスごとに 1 つの ServiceInstaller インスタンスを作成します。 プロジェクト インストーラー クラス コンストラクター内で、 インスタンスと ServiceInstaller インスタンスを使用してサービスのインストール プロパティをServiceProcessInstaller設定し、インスタンスをコレクションにInstallers追加します。

クラスからInstaller派生するすべてのクラスについて、コレクションの状態は Installers メソッドと Uninstall メソッドでInstall同じである必要があります。 ただし、カスタム インストーラー クラス コンストラクターのコレクションにインストーラー インスタンスを追加すると、 メソッドと Uninstall メソッド全体InstallでコレクションのInstallersメンテナンスを回避できます。インストール ユーティリティが呼び出されると、 属性が検索されますRunInstallerAttribute。 属性が の場合、 trueプロジェクト インストーラーに関連付けられたコレクションに Installers 追加されたすべてのサービスがユーティリティによってインストールされます。 が false または 存在しない場合RunInstallerAttribute、インストール ユーティリティはプロジェクト インストーラーを無視します。

プロジェクト インストール クラスに関連付けられている には ServiceProcessInstaller 、プロジェクト内のすべての ServiceInstaller インスタンスに共通する情報がインストールされます。 このサービスにインストール プロジェクト内の他のサービスとは別のサービスがある場合、そのサービス固有の情報はこのメソッドによってインストールされます。

プロジェクト インストーラーのコレクションに追加する ServiceInstaller 前または後に、 Installers の他のプロパティを変更できます。 たとえば、再起動時にサービスを自動的に開始するようにサービスを StartType 設定したり、ユーザーにサービスを手動で開始させる必要がある場合があります。

通常、コード内で メソッド ServiceInstaller を呼び出すわけではありません。通常、これらはインストール ユーティリティによってのみ呼び出されます。 インストール ユーティリティは、インストール プロセス中に ServiceProcessInstaller.Install メソッドと ServiceInstaller.Install メソッドを自動的に呼び出します。 必要に応じて、以前にインストールされたすべてのコンポーネントで (または ServiceInstaller.Rollback) を呼び出Rollbackして、エラーをバックアウトします。

インストール ユーティリティは、 を呼び出 Uninstall して オブジェクトを削除します。

アプリケーションのインストール ルーチンでは、プロジェクト インストーラーの を使用して、既にインストールされているコンポーネントに関する情報が Installer.Context自動的に保持されます。 この状態情報はインスタンスとして ServiceProcessInstaller 継続的に更新され、各 ServiceInstaller インスタンスはユーティリティによってインストールされます。 通常、コードで状態情報を明示的に変更する必要があります。

インストールが実行されると、 が自動的に作成 EventLogInstaller され、派生クラスに関連付けられているイベント ログ ソースが ServiceBase インストールされます。 このソースの プロパティは Log 、コンストラクターによって ServiceInstaller コンピューターのアプリケーション ログに設定されます。 の を ServiceName 設定すると (サービスの ServiceInstaller と同じである ServiceBase.ServiceName 必要があります) Source 、 は自動的に同じ値に設定されます。 インストールエラーでは、ソースのインストールは、以前にインストールされたサービスと共にロールバックされます。

メソッドは Uninstall 、サービスが実行されている場合にサービスの停止を試みます。 これが成功したかどうかに関係なく、 Uninstall によって Install行われた変更を元に戻します。 イベント ログ用に新しいソースが作成された場合、ソースは削除されます。

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

• ServiceName
• ServiceProcessInstaller
• ServiceBase
• EventLog