Skip to content

User element (Util extension)

User for all kinds of things. When it is not nested under a component it is included in the MSI so it can be referenced by other elements such as the User attribute in the AppPool element. When it is nested under a Component element, the User will be created on install and can also be used for reference.

Attributes

Section titled “Attributes”

CanNotChangePassword

bool

The user cannot change the account’s password. Equivalent to UF_PASSWD_CANT_CHANGE.

Comment

string

Optional comment to set on the user.

CreateUser

bool

Indicates whether or not to create the user. User creation can be skipped if all that is desired is to join a user to groups.

Disabled

bool

The account is disabled. Equivalent to UF_ACCOUNTDISABLE.

Domain

string

A Formatted string that contains the local machine or Active Directory domain for the user.

FailIfExists

bool

Indicates if the install should fail if the user already exists.

Id

string

LogonAsBatchJob

bool

Indicates whether or not the user can logon as a batch job. User creation can be skipped if all that is desired is to set this access right on the user.

LogonAsService

bool

Indicates whether or not the user can logon as a serivce. User creation can be skipped if all that is desired is to set this access right on the user.

Name

string required

A Formatted string that contains the name of the user account.

Password

string

Usually a Property that is passed in on the command-line to keep it more secure.

PasswordExpired

bool

Indicates whether the user must change their password on their first login.

PasswordNeverExpires

bool

The account’s password never expires. Equivalent to UF_DONT_EXPIRE_PASSWD.

RemoveComment

bool

Indicates whether remove the comment from the user. The default value is “no”.

RemoveOnUninstall

bool

Indicates whether the user account should be removed or left behind on uninstall.

UpdateIfExists

bool

Indicates if the user account properties should be updated if the user already exists.

Vital

bool

Indicates whether failure to create the user or add the user to a group fails the installation. The default value is “yes”.

Children

Section titled “Children”
GroupRef

Parents

Section titled “Parents”
Component (Wxs extension)
Fragment (Wxs extension)
Module (Wxs extension)
Package (Wxs extension)

See also

Section titled “See also”

Group, GroupRef