add Element for credentials for authentication [IIS Settings Schema]

Article
10/21/2021

Note

For more information about the add element, see the following topic on the Microsoft IIS.net Web site: Adding Management Authentication Credentials <add>.

Adds an IIS Manager user account to the collection of IIS Manager users. IIS Manager users can use IIS Manager to connect to sites and applications for which they are authorized by a server administrator.

Syntax

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

Attribute	Description
name	Required string attribute. Specifies the user name of the IIS Manager user account.
password	Required string attribute. Specifies the SHA256 hash of the user's password for the IIS Manager user account. This attribute is case sensitive. If you configure an IIS Manager user account by using IIS Manager, the password hash is computed automatically. If you want to calculate the hash of a password programmatically, you can use the System.Security.Cryptography.SHA256 ComputeHash method. For more information, see SHA256 Class on MSDN.
enabled	Optional Boolean attribute. Specifies whether the IIS Manager user is enabled (true) or disabled (false). When true, the IIS Manager user can use IIS Manager to connect to all sites and applications for which they have authorized by a server administrator on the Web server. The default value is true.

name

Required string attribute.

Specifies the user name of the IIS Manager user account.

password

Required string attribute.

Specifies the SHA256 hash of the user's password for the IIS Manager user account. This attribute is case sensitive.

If you configure an IIS Manager user account by using IIS Manager, the password hash is computed automatically. If you want to calculate the hash of a password programmatically, you can use the System.Security.Cryptography.SHA256

ComputeHash method. For more information, see SHA256 Class on MSDN.

enabled

Optional Boolean attribute.

Specifies whether the IIS Manager user is enabled (true) or disabled (false). When true, the IIS Manager user can use IIS Manager to connect to all sites and applications for which they have authorized by a server administrator on the Web server.

The default value is true.

Child Elements

None.

Parent Elements

Element	Description
configuration	Specifies the root element in every configuration file that is used by IIS 7.
system.webServer	Specifies the top-level section group (in Administration.config) in which this element is defined.
management	Configures a Web server for remote management by using IIS Manager.
authentication	Configures authentication settings for remote management of the Web server.
credentials	Configures credentials for IIS Manager user accounts.

Remarks

For more information about the add element, see the following topic on the Microsoft IIS.net Web site: Adding Management Authentication Credentials <add>.

Element Information

Configuration locations	Root Administration.config
Requirements	Microsoft Internet Information Services (IIS) version 7.0