ServiceProcessInstaller Clase

Definición

Instala un ejecutable que contiene clases que extienden ServiceBase.Installs an executable containing classes that extend ServiceBase. Las utilidades de instalación, como InstallUtil.exe, llaman a esta clase al instalar una aplicación de servicio.This class is called by installation utilities, such as InstallUtil.exe, when installing a service application.

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

Ejemplos

En el ejemplo siguiente se crea un instalador de proyecto denominado MyProjectInstaller, que Installerhereda de.The following example creates a project installer called MyProjectInstaller, which inherits from Installer. Se supone que hay un ejecutable de servicio que contiene dos servicios: "Hello-World Service 1" y "Hello-World Service 2".It is assumed there is a service executable that contains two services, "Hello-World Service 1" and "Hello-World Service 2". En el 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.Within the constructor for MyProjectInstaller (which would be called by the install utility), ServiceInstaller objects are created for each service, and a ServiceProcessInstaller is created for the executable. Para que la utilidad de instalación reconozca MyProjectInstaller como un instalador válido RunInstallerAttribute , el atributo se trueestablece en.For the install utility to recognize MyProjectInstaller as a valid installer, the RunInstallerAttribute attribute is set to true.

Las propiedades opcionales se establecen en el instalador de proceso y los instaladores de servicio antes de que los instaladores se agreguen a la Installers colección.Optional properties are set on the process installer and the service installers before the installers are added to the Installers collection. Cuando la utilidad de instalación de tiene acceso a MyProjectInstaller, los objetos Installers agregados a la colección InstallerCollection.Add a través de una llamada a se instalarán a su vez.When the install utility accesses MyProjectInstaller, the objects added to the Installers collection through a call to InstallerCollection.Add will be installed in turn. Durante el proceso, el instalador mantiene información de estado que indica qué objetos se han instalado, por lo que se puede hacer una copia de seguridad de cada objeto a su vez en caso de error de instalación.During the process, the installer maintains state information indicating which objects have been installed, so each object can be backed out in turn in case of an installation failure.

Normalmente, no se crea una instancia de la clase del instalador del proyecto explícitamente.Normally, you would not instantiate your project installer class explicitly. Lo crearía y agregaría RunInstallerAttribute, pero la utilidad de instalación llama realmente a y, por tanto, crea una instancia de la clase.You would create it and add the RunInstallerAttribute, but the install utility actually calls, and therefore instantiates, the class.

#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

La ServiceProcessInstaller tarea es común a todos los servicios de un archivo ejecutable.The ServiceProcessInstaller does work common to all services in an executable. La utilidad de instalación la usa para escribir los valores del registro asociados a los servicios que desea instalar.It is used by the installation utility to write registry values associated with services you want to install.

Para instalar un servicio, cree una clase de instalador de proyecto que herede Installerde y RunInstallerAttribute establezca en la clase trueen.To install a service, create a project installer class that inherits from Installer, and set the RunInstallerAttribute on the class to true. En el proyecto, cree ServiceProcessInstaller una instancia de cada aplicación de servicio y una ServiceInstaller instancia para cada servicio de la aplicación.Within your project, instantiate one ServiceProcessInstaller instance per service application, and one ServiceInstaller instance for each service in the application. Por último, agregue ServiceProcessInstaller la instancia de ServiceInstaller y las instancias de a la clase de instalador del proyecto.Finally, add the ServiceProcessInstaller instance and the ServiceInstaller instances to your project installer class.

Cuando se ejecuta Installutil. exe, la utilidad busca las clases en el ensamblado de RunInstallerAttribute servicio con trueel establecido en.When InstallUtil.exe runs, the utility looks for classes in the service assembly with the RunInstallerAttribute set to true. Agregue clases al ensamblado de servicio agregándolas a la Installers colección asociada al instalador del proyecto.Add classes to the service assembly by adding them to the Installers collection associated with your project installer. Si RunInstallerAttribute esfalse, la utilidad de instalación omite el instalador del proyecto.If RunInstallerAttribute is false, the install utility ignores the project installer.

En el caso de ServiceProcessInstalleruna instancia de, las propiedades que puede modificar incluyen la especificación de que una aplicación de servicio se ejecuta en una cuenta que no sea la del usuario que ha iniciado sesión.For an instance of ServiceProcessInstaller, properties you can modify include specifying that a service application run under an account other than the logged-on user. Puede especificar un par determinado Username y Password en el que se debe ejecutar el servicio, o puede usar Account para especificar que el servicio se ejecute en la cuenta del sistema del equipo, en una cuenta de servicio local o de red, o en una cuenta de usuario.You can specify a particular Username and Password pair under which the service should run, or you can use Account to specify that the service run under the computer's System account, a local or network service account, or a user account.

Nota

La cuenta del sistema del equipo no es la misma que la cuenta de administrador.The computer's System account is not the same as the Administrator account.

Normalmente, no se llama a los métodos en ServiceInstaller dentro del código; normalmente solo los llama la utilidad de instalación.Normally, you do not call the methods on ServiceInstaller within your code; they are generally called only by the install utility. La utilidad de instalación de llama ServiceProcessInstaller.Install automáticamente ServiceInstaller.Install a los métodos y durante el proceso de instalación.The install utility automatically calls the ServiceProcessInstaller.Install and ServiceInstaller.Install methods during the installation process. Hace una copia de seguridad de los errores, si es Rollback necesario, ServiceInstaller.Rollbackmediante una llamada a (o) en todos los componentes instalados anteriormente.It backs out failures, if necessary, by calling Rollback (or ServiceInstaller.Rollback) on all previously installed components.

La rutina de instalación de una aplicación mantiene información automáticamente sobre los componentes ya instalados, mediante el uso Installer.Contextdel instalador del proyecto.An application's install routine maintains information automatically about the components already installed, using the project installer's Installer.Context. Esta información de estado se actualiza continuamente como ServiceProcessInstaller la instancia y ServiceInstaller la utilidad instala cada instancia.This state information is continuously updated as the ServiceProcessInstaller instance and each ServiceInstaller instance is installed by the utility. Normalmente no es necesario que el código modifique esta información de estado explícitamente.It is usually unnecessary for your code to modify this state information explicitly.

La creación de ServiceProcessInstaller instancias de hace que se llame ComponentInstalleral constructor de clase base,,.Instantiating a ServiceProcessInstaller causes the base class constructor, ComponentInstaller, to be called.

Constructores

ServiceProcessInstaller()

Crea una nueva instancia de la clase ServiceProcessInstaller.Creates a new instance of the ServiceProcessInstaller class.

Propiedades

Account

Obtiene o establece el tipo de cuenta en la que se ejecutará esta aplicación de servicio.Gets or sets the type of account under which to run this service application.

CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Heredado de Component)
Container

Obtiene IContainer que contiene Component.Gets the IContainer that contains the Component.

(Heredado de Component)
Context

Obtiene o establece información sobre la instalación actual.Gets or sets information about the current installation.

(Heredado de Installer)
DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Heredado de Component)
Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Heredado de Component)
HelpText

Obtiene un texto de ayuda que se muestra para las opciones de instalación del servicio.Gets help text displayed for service installation options.

Installers

Obtiene la colección de instaladores que contiene este instalador.Gets the collection of installers that this installer contains.

(Heredado de Installer)
Parent

Obtiene o establece el instalador que contiene la colección a la que pertenece este instalador.Gets or sets the installer containing the collection that this installer belongs to.

(Heredado de Installer)
Password

Obtiene o establece la contraseña asociada a la cuenta de usuario en la que se ejecuta la aplicación de servicio.Gets or sets the password associated with the user account under which the service application runs.

Site

Obtiene o establece el ISite de Component.Gets or sets the ISite of the Component.

(Heredado de Component)
Username

Obtiene o establece la cuenta de usuario en la que se ejecutará la aplicación de servicio.Gets or sets the user account under which the service application will run.

Métodos

Commit(IDictionary)

Cuando se reemplaza en una clase derivada, finaliza la transacción de instalación.When overridden in a derived class, completes the install transaction.

(Heredado de Installer)
CopyFromComponent(IComponent)

Implementa el método CopyFromComponent(IComponent) de la clase base sin un comportamiento específico de la clase ServiceProcessInstaller.Implements the base class CopyFromComponent(IComponent) method with no ServiceProcessInstaller class-specific behavior.

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

(Heredado de Component)
Dispose(Boolean)

Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Heredado de Component)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Heredado de Component)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
Install(IDictionary)

Escribe información de la aplicación de servicio en el Registro.Writes service application information to the registry. Este método está pensado para que lo utilicen las herramientas de instalación, que llaman automáticamente a los métodos adecuados.This method is meant to be used by installation tools, which call the appropriate methods automatically.

IsEquivalentInstaller(ComponentInstaller)

Determina si el instalador especificado instala el mismo objeto que este instalador.Determines if the specified installer installs the same object as this installer.

(Heredado de ComponentInstaller)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
OnAfterInstall(IDictionary)

Genera el evento AfterInstall.Raises the AfterInstall event.

(Heredado de Installer)
OnAfterRollback(IDictionary)

Genera el evento AfterRollback.Raises the AfterRollback event.

(Heredado de Installer)
OnAfterUninstall(IDictionary)

Genera el evento AfterUninstall.Raises the AfterUninstall event.

(Heredado de Installer)
OnBeforeInstall(IDictionary)

Genera el evento BeforeInstall.Raises the BeforeInstall event.

(Heredado de Installer)
OnBeforeRollback(IDictionary)

Genera el evento BeforeRollback.Raises the BeforeRollback event.

(Heredado de Installer)
OnBeforeUninstall(IDictionary)

Genera el evento BeforeUninstall.Raises the BeforeUninstall event.

(Heredado de Installer)
OnCommitted(IDictionary)

Genera el evento Committed.Raises the Committed event.

(Heredado de Installer)
OnCommitting(IDictionary)

Genera el evento Committing.Raises the Committing event.

(Heredado de Installer)
Rollback(IDictionary)

Deshace la información de la aplicación de servicio que el procedimiento de instalación escribió en el Registro.Rolls back service application information written to the registry by the installation procedure. Este método está pensado para que lo utilicen las herramientas de instalación que procesan automáticamente los métodos apropiados.This method is meant to be used by installation tools, which process the appropriate methods automatically.

ToString()

Devuelve una String que contiene el nombre del Component, si existe.Returns a String containing the name of the Component, if any. Este método no se debe invalidar.This method should not be overridden.

(Heredado de Component)
Uninstall(IDictionary)

Cuando se reemplaza en una clase derivada, quita una instalación.When overridden in a derived class, removes an installation.

(Heredado de Installer)

Eventos

AfterInstall

Se produce después de ejecutarse los métodos Install(IDictionary) de todos los instaladores de la propiedad Installers.Occurs after the Install(IDictionary) methods of all the installers in the Installers property have run.

(Heredado de Installer)
AfterRollback

Se produce después de deshacerse la instalación de todos los instaladores de la propiedad Installers.Occurs after the installations of all the installers in the Installers property are rolled back.

(Heredado de Installer)
AfterUninstall

Se produce después de que todos los instaladores de la propiedad Installers realicen sus operaciones de desinstalación.Occurs after all the installers in the Installers property perform their uninstallation operations.

(Heredado de Installer)
BeforeInstall

Se produce antes de ejecutarse el método Install(IDictionary) de cada instalador en la colección de instaladores.Occurs before the Install(IDictionary) method of each installer in the installer collection has run.

(Heredado de Installer)
BeforeRollback

Se produce antes de deshacerse los instaladores de la propiedad Installers.Occurs before the installers in the Installers property are rolled back.

(Heredado de Installer)
BeforeUninstall

Se produce antes de que los instaladores de la propiedad Installers realicen sus operaciones de desinstalación.Occurs before the installers in the Installers property perform their uninstall operations.

(Heredado de Installer)
Committed

Se produce después de que todos los instaladores de la propiedad Installers confirmen sus instalaciones.Occurs after all the installers in the Installers property have committed their installations.

(Heredado de Installer)
Committing

Se produce antes de que los instaladores de la propiedad Installers confirmen sus instalaciones.Occurs before the installers in the Installers property commit their installations.

(Heredado de Installer)
Disposed

Se produce cuando el componente se elimina mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Heredado de Component)

Se aplica a

Consulte también: