ServiceAccount Enumeração

Definição

Namespace:

System.ServiceProcess

Assembly:

System.ServiceProcess.dll

Especifica o contexto de segurança do serviço, que define o tipo de logon.

public enum class ServiceAccount

public enum ServiceAccount

type ServiceAccount = 

Public Enum ServiceAccount

Herança

Object

ValueType

Enum

ServiceAccount

Campos

LocalService	0	Uma conta que atua como um usuário não privilegiado no computador local e apresenta credenciais anônimas a qualquer servidor remoto.
LocalSystem	2	Uma conta, usada pelo gerenciador de controle de serviço, que tem privilégios extensos no computador local e funciona como o computador na rede.
NetworkService	1	Uma conta que fornece privilégios locais abrangentes e apresenta as credenciais do computador para qualquer servidor remoto.
User	3	Uma conta definida por um usuário específico na rede. Especificando User para o membro Account faz com que o sistema solicite um nome de usuário válido e uma senha quando o serviço é instalado, a menos que você defina valores para ambas as propriedades Username e Password de sua ServiceProcessInstaller instância.

Exemplos

O exemplo de código a seguir demonstra como usar a ServiceAccount enumeração para instalar novos programas usando o contexto de segurança da conta do sistema.

#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

Comentários

Use a ServiceAccount enumeração ao inicializar uma ServiceProcessInstaller para especificar o contexto de segurança do serviço que você está instalando. O contexto de segurança indica os privilégios que um serviço tem no sistema e como os serviços atuam na rede (por exemplo, se o serviço apresenta as credenciais do computador ou credenciais anônimas para servidores remotos). A ServiceAccount enumeração fornece um intervalo de privilégios para que você possa especificar exatamente os privilégios necessários para qualquer serviço específico.

O LocalSystem valor define uma conta altamente privilegiada, mas a maioria dos serviços não exige um nível de privilégio tão elevado. Os LocalService membros enumeração NetworkService fornecem um nível de privilégio inferior para o contexto de segurança.

Observação

Os valores LocalService e NetworkService estão disponíveis apenas em Windows família XP e Windows Server 2003.

Confira também

• ServiceProcessInstaller
• ServiceInstallerDialog