ServiceProcessInstaller.Username Property

Definition

Namespace:

System.ServiceProcess

Assembly:

System.ServiceProcess.dll

Gets or sets the user account under which the service application will run.

public:
 property System::String ^ Username { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.Browsable(false)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Username { get; set; }

[<System.ComponentModel.Browsable(false)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Username : string with get, set

Public Property Username As String

Property Value

String

The account under which the service should run. The default is an empty string ("").

Attributes

BrowsableAttribute TypeConverterAttribute

Remarks

The Username and Password pair allows the service to run under an account other than the system account. This can, for example, allow the service to start automatically at reboot, when no user is logged on.

Password and Username are handled in a secure manner in that they are never serialized or saved to the install state (the project installer's Installer.Context) or other location with public access.

Setting the Username and Password allows an account to be associated automatically with the service at install time. If you leave either the Username or Password empty and set Account to User, you will be prompted for a valid user name and password at installation.

Another option for running a service under a separate account is to use the computer's System account. That account, which is distinct from the Administrator account, requires no password. The System account's privileges may exceed those of the user currently logged in. Running under the System account rather than a user account avoids problems resulting from the user lacking a permission the service requires

If Account is any value other than User, the specified account (local or network service, or local system) is used, even if the Username and Password properties are populated.

See also

• Password
• Account
• ServiceInstallerDialog