ServiceProcessInstaller Clase

Definición

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

Herencia

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceProcessInstaller

Ejemplos

En el ejemplo siguiente se crea un instalador de proyecto denominado MyProjectInstaller, que hereda de Installer. Se supone que hay un archivo ejecutable de servicio que contiene dos servicios: "Hello-World Service 1" y "Hello-World Service 2". Dentro del constructor de MyProjectInstaller (al que llamaría la utilidad de instalación), ServiceInstaller se crean objetos para cada servicio y se crea un ServiceProcessInstaller para el ejecutable. Para que la utilidad de instalación reconozca MyProjectInstaller como un instalador válido, el RunInstallerAttribute atributo se establece trueen .

Las propiedades opcionales se establecen en el instalador de proceso y los instaladores de servicio antes de que se agreguen los instaladores a la Installers colección. Cuando la utilidad de instalación tiene acceso a MyProjectInstaller, los objetos agregados a la Installers colección a través de una llamada a InstallerCollection.Add se instalarán a su vez. Durante el proceso, el instalador mantiene información de estado que indica qué objetos se han instalado, por lo que cada objeto se puede recuperar a su vez en caso de un error de instalación.

Normalmente, no crearía instancias de la clase del instalador del proyecto explícitamente. Lo crearía y agregaría , RunInstallerAttributepero la utilidad de instalación llama realmente y, por tanto, crea instancias de la clase .

#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

Comentarios

ServiceProcessInstaller funciona de forma común a todos los servicios de un archivo ejecutable. La utilidad de instalación la usa para escribir valores del Registro asociados a los servicios que desea instalar.

Para instalar un servicio, cree una clase de instalador de proyecto que herede de Installery establezca en RunInstallerAttribute en .true Dentro del proyecto, cree una ServiceProcessInstaller instancia por aplicación de servicio y una ServiceInstaller instancia para cada servicio de la aplicación. Por último, agregue la ServiceProcessInstaller instancia y las instancias a la ServiceInstaller clase del instalador del proyecto.

Cuando se ejecuta InstallUtil.exe, la utilidad busca clases en el ensamblado de servicio con el RunInstallerAttribute establecido trueen . Agregue clases al ensamblado de servicio agregándolos a la Installers colección asociada al instalador del proyecto. Si RunInstallerAttribute es false, la utilidad de instalación omite el instalador del proyecto.

Para una instancia de ServiceProcessInstaller, las propiedades que puede modificar incluyen especificar que una aplicación de servicio se ejecute en una cuenta distinta del usuario que ha iniciado sesión. Puede especificar un par y Password determinado Username en el que se debe ejecutar el servicio, o bien puede usar Account para especificar que el servicio se ejecute en la cuenta del sistema del equipo, una cuenta de servicio local o de red o una cuenta de usuario.

Normalmente, no se llama a los métodos ServiceInstaller en el código; por lo general, la utilidad de instalación solo los llama. La utilidad de instalación llama automáticamente a los ServiceProcessInstaller.Install métodos y ServiceInstaller.Install durante el proceso de instalación. Devuelve errores, si es necesario, llamando a Rollback (o ServiceInstaller.Rollback) en todos los componentes instalados anteriormente.

La rutina de instalación de una aplicación mantiene información automáticamente sobre los componentes ya instalados mediante el instalador del Installer.Contextproyecto. Esta información de estado se actualiza continuamente a medida que la ServiceProcessInstaller instancia y la utilidad instala cada ServiceInstaller instancia. Por lo general, no es necesario que el código modifique esta información de estado explícitamente.

La creación de instancias de hace ServiceProcessInstaller que se llame al constructor de clase base, ComponentInstaller, .

Constructores

Propiedades

Métodos

Eventos

Se aplica a

Consulte también

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