ServiceAccount ServiceAccount ServiceAccount ServiceAccount Enum

定義

サービスのセキュリティ コンテキストを指定します。このコンテキストにより、そのサービスのログオンの種類が定義されます。Specifies a service's security context, which defines its logon type.

public enum class ServiceAccount
public enum ServiceAccount
type ServiceAccount = 
Public Enum ServiceAccount
継承
ServiceAccountServiceAccountServiceAccountServiceAccount

フィールド

LocalService LocalService LocalService LocalService 0

ローカル コンピューター上の特権を与えられていないユーザーとして機能するアカウント。このアカウントは、匿名の資格情報をリモート サーバーに提示します。An account that acts as a non-privileged user on the local computer, and presents anonymous credentials to any remote server.

LocalSystem LocalSystem LocalSystem LocalSystem 2

ローカル コンピューター上で広範囲の特権を持ち、ネットワーク上のコンピューターとして機能するアカウント。このアカウントは、サービス コントロール マネージャーが使用します。An account, used by the service control manager, that has extensive privileges on the local computer and acts as the computer on the network.

NetworkService NetworkService NetworkService NetworkService 1

広範囲のローカル特権を提供するアカウント。このアカウントは、コンピューターの資格情報をリモート サーバーに提示します。An account that provides extensive local privileges, and presents the computer's credentials to any remote server.

User User User User 3

ネットワーク上の特定のユーザーによって定義されたアカウント。An account defined by a specific user on the network. Account メンバーに対して User を指定すると、Username インスタンスの Password プロパティ値と ServiceProcessInstaller プロパティ値を設定していない限りは、サービスのインストール時に有効なユーザー名とパスワードを入力するように要求されます。Specifying User for the Account member causes the system to prompt for a valid user name and password when the service is installed, unless you set values for both the Username and Password properties of your ServiceProcessInstaller instance.

次のコード例は、 ServiceAccount列挙を使用して、システムアカウントのセキュリティコンテキストを使用して新しいプログラムをインストールする方法を示しています。The following code example demonstrates how to use the ServiceAccount enumeration to install new programs by using the system account's security context.

#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

注釈

ServiceAccountServiceProcessInstaller初期化するときに列挙体を使用して、インストールするサービスのセキュリティコンテキストを指定します。Use the ServiceAccount enumeration when you initialize a ServiceProcessInstaller to specify the security context of the service you are installing. セキュリティコンテキストは、サービスがシステムに対して持つ特権と、サービスがネットワーク上でどのように動作するか (たとえば、サービスがコンピューターの資格情報または匿名の資格情報をリモートサーバーに提示するかどうかなど) を示します。The security context indicates the privileges a service has on the system and how the services act on the network (for example, whether the service presents the computer's credentials or anonymous credentials to remote servers). 列挙ServiceAccount体は、特定のサービスに必要な特権を正確に指定できるように、さまざまな特権を提供します。The ServiceAccount enumeration provides a range of privileges so that you can specify exactly the privileges you need for any particular service.

LocalSystemは高い特権を持つアカウントを定義しますが、ほとんどのサービスではこのような特権レベルの昇格は必要ありません。The LocalSystem value defines a highly privileged account, but most services do not require such an elevated privilege level. LocalServiceNetworkService列挙型のメンバーは、セキュリティコンテキストに対して低い特権レベルを提供します。The LocalService and NetworkService enumeration members provide a lower privilege level for the security context.

注意

LocalService およびNetworkServiceは、windows XP と windows Server 2003 ファミリでのみ使用できます。The values LocalService and NetworkService are available only on Windows XP and Windows Server 2003 family.

適用対象

こちらもご覧ください