ServiceProcessInstaller クラス

定義

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

public class ServiceProcessInstaller : System.Configuration.Install.ComponentInstaller

type ServiceProcessInstaller = class
    inherit ComponentInstaller

Public Class ServiceProcessInstaller
Inherits ComponentInstaller

継承

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceProcessInstaller

例

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

注釈

ServiceProcessInstallerは、実行可能ファイル内のすべてのサービスに共通して機能します。 インストール ユーティリティは、インストールするサービスに関連付けられているレジストリ値を書き込む目的で使用されます。

サービスをインストールするには、 Installerから継承するプロジェクト インストーラー クラスを作成し、クラスの RunInstallerAttribute を true に設定します。 プロジェクト内で、サービス アプリケーションごとに 1 つの ServiceProcessInstaller インスタンスと、アプリケーション内のサービスごとに 1 つの ServiceInstaller インスタンスをインスタンス化します。 最後に、 ServiceProcessInstaller インスタンスと ServiceInstaller インスタンスをプロジェクト インストーラー クラスに追加します。

InstallUtil.exe 実行すると、 RunInstallerAttribute が true に設定されたサービス アセンブリ内のクラスが検索されます。 プロジェクト インストーラーに関連付けられている Installers コレクションにクラスを追加して、サービス アセンブリにクラスを追加します。 RunInstallerAttributeがfalseされている場合、インストール ユーティリティはプロジェクト インストーラーを無視します。

ServiceProcessInstallerのインスタンスの場合、変更できるプロパティには、ログオンしているユーザー以外のアカウントでサービス アプリケーションを実行することを指定するプロパティが含まれます。 サービスを実行する特定の Username と Password のペアを指定することも、 Account を使用して、コンピューターのシステム アカウント、ローカルまたはネットワーク サービス アカウント、またはユーザー アカウントでサービスを実行するように指定することもできます。

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

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

ServiceProcessInstallerをインスタンス化すると、基底クラスコンストラクター (ComponentInstaller) が呼び出されます。

こちらもご覧ください

• ServiceInstaller
• ServiceBase
• ComponentInstaller
• Installers
• ServiceAccount
• ServiceInstallerDialog