Share via

  • Article

sp_approlepassword (Transact-SQL)

Changes the password of an application role in the current database.

Important

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Use ALTER APPLICATION ROLE instead.

Topic link iconTransact-SQL Syntax Conventions

Syntax

sp_approlepassword [ @rolename= ] 'role' , [ @newpwd = ] 'password'

Arguments

  • [ @rolename = ] 'role'
    Is the name of the application role. Role is sysname, with no default. role must exist in the current database.

  • [ @newpwd = ] 'password'
    Is the new password for the application role. password is sysname, with no default. password cannot be NULL.

    Security noteSecurity Note

    Do not use a NULL password. Use a strong password. For more information, see Strong Passwords.

Return Code Values

0 (success) or 1 (failure)

Remarks

sp_approlepassword cannot be executed within a user-defined transaction.

Permissions

Requires ALTER ANY APPLICATION ROLE permission on the database.

Examples

The following example sets the password for the PayrollAppRole application role to B3r12-36.

EXEC sp_approlepassword 'PayrollAppRole', '''B3r12-36'