SQL Server ALTER LOGIN

Summary: in this tutorial, you’ll learn how to use the SQL Server ALTER LOGIN statement to change the properties of a login account.

To change the properties of a login account, you use the ALTER LOGIN statement. Before using the ALTER LOGIN statement, let’s create a new login first:

CREATE LOGIN bobcat
WITH PASSWORD = 'Mou$eY2k.';Code language: SQL (Structured Query Language) (sql)

Disable a login

The following ALTER LOGIN statement disables a login account:

ALTER LOGIN login_name
DISABLE;Code language: SQL (Structured Query Language) (sql)

For example, the following statement disables the login bobcat:

ALTER LOGIN bobcat
DISABLE;Code language: SQL (Structured Query Language) (sql)

Once disabled, you cannot use the bobcat to log in to the SQL Server.

Enable a disabled login

The following ALTER LOGIN statement enables a login:

ALTER LOGIN bobcat
ENABLE;Code language: SQL (Structured Query Language) (sql)

For example, the following statement enables the login bobcat:

ALTER LOGIN bobcat
ENABLE;Code language: SQL (Structured Query Language) (sql)

Once enabled, you can use bobcat to log in to the SQL Server.

Rename a login

The following ALTER LOGIN ... WITH NAME change the name of a login to a new one:

ALTER LOGIN login_name 
WITH NAME = new_name;Code language: SQL (Structured Query Language) (sql)

For example, the following statement changes the login bobcat to lion:

ALTER LOGIN bobcat
WITH NAME = lion;Code language: SQL (Structured Query Language) (sql)

Change the password of a login

To change the password of a login, you use the ALTER LOGIN ... WITH PASSWORD statement:

ALTER LOGIN login_name
WITH PASSWORD = new_password;Code language: SQL (Structured Query Language) (sql)

For example, the following statement changes the password of the login lion to a new one:

ALTER LOGIN lion
WITH PASSWORD = 'Hor$e2022.';Code language: SQL (Structured Query Language) (sql)

If a login account is currently logged in and you do not have the ALTER ANY LOGIN permission, you need to specify the OLD_PASSWORD option:

ALTER LOGIN login_name
WITH PASSWORD = new_password 
     OLD_PASSWORD = old_password;Code language: SQL (Structured Query Language) (sql)

For example:

ALTER LOGIN lion
WITH PASSWORD = 'Deer$2022.' 
	 OLD_PASSWORD = 'Hor$e2022.';Code language: SQL (Structured Query Language) (sql)

If you migrate the login accounts from a legacy database and want to reuse the old password, you can use the hashed password. For example:

ALTER LOGIN legacy
WITH PASSWORD=0x0200B6E66AFC7FF8B4EBCB553B3F95C4A566E724CC2C6265C0C2663DA89C96C38B230C2468DC46E11A3AA32522D3E074D91D9C5A32A9C8535A9DCF3EB49AB233E340C2345EF7
HASHED;Code language: SQL (Structured Query Language) (sql)

Unlock a login

If you enforce a password policy on a login and the login account failed a number of times, the login can be locked.

To unlock a login account, you use the ALTER LOGIN ... UNLOCK statement:

ALTER LOGIN login_name
WITH PASSWORD=password
UNLOCK;Code language: SQL (Structured Query Language) (sql)

For example:

ALTER LOGIN lion
WITH PASSWORD='Deer$2023.'
UNLOCK;Code language: SQL (Structured Query Language) (sql)

Summary

  • Use the ALTER LOGIN statement to change the properties of a login account.
Was this tutorial helpful?