ALTER LOGIN (Transact-SQL) - 分析平台系统(PDW)

适用于:Analytics Platform System (PDW)

更改 SQL Server 登录帐户的属性。

注释

Microsoft Entra ID 旧称 Azure Active Directory (Azure AD)。

Transact-SQL 语法约定

语法

ALTER LOGIN login_name
    {
    <status_option>
    | WITH <set_option> [ , ... ]
    }

<status_option> ::= ENABLE | DISABLE

<set_option> ::=
    PASSWORD = 'password'
    [
      OLD_PASSWORD = 'oldpassword'
      | <password_option> [ <password_option> ]
    ]
    | NAME = login_name
    | CHECK_POLICY = { ON | OFF }
    | CHECK_EXPIRATION = { ON | OFF }

<password_option> ::=
    MUST_CHANGE | UNLOCK

Arguments

login_name

指定正在更改的 SQL Server 登录名的名称。 域登录名必须用括号括起来,格式为 [domain\user]。

ENABLE |禁用

启用或禁用此登录名。 禁用登录不会影响已连接的登录行为。 (使用 KILL 语句终止现有连接。禁用的登录名保留其权限,但仍可以模拟。

PASSWORD = 'password'

仅适用于 SQL Server 登录名。 指定正在更改的登录名的密码。 密码是区分大小写的。

Important

登录名(或包含的数据库用户)连接并进行身份验证时,连接将缓存有关登录名的标识信息。 对于 Windows 身份验证登录名,这包括有关 Windows 组中的成员身份的信息。 只要保持连接,登录名的标识将保持身份验证。 若要强制更改标识(如密码重置或更改 Windows 组成员身份),登录必须从身份验证机构(Windows 或 SQL Server)注销,然后再次登录。 sysadmin 固定服务器角色或任何具有 ALTER ANY CONNECTION 权限的登录名的成员可以使用 KILL 命令结束连接并强制登录重新连接。 打开与对象资源管理器和查询编辑器窗口的多个连接时,SQL Server Management Studio(SSMS)可以重复使用连接信息。 关闭所有连接以强制重新连接。

OLD_PASSWORD = “old_password”

仅适用于 SQL Server 登录名。 将向其分配新密码的登录名的当前密码。 密码是区分大小写的。

MUST_CHANGE

仅适用于 SQL Server 登录名。 如果包含此选项,则首次使用更改的登录名时,SQL Server 会提示输入更新的密码。

姓名 = login_name

正在重命名的登录名的新名称。 如果登录名是 Windows 登录名,则对应于新名称的 Windows 主体的 SID 必须与与 SQL Server 中的登录名关联的 SID 匹配。 SQL Server 登录名的新名称不能包含反斜杠字符 (\)。

CHECK_EXPIRATION = { ON |OFF }

仅适用于 SQL Server 登录名。 指定是否应对此登录帐户强制实施密码过期策略。 默认值为 OFF。

CHECK_POLICY = { ON |OFF }

仅适用于 SQL Server 登录名。 指定应对此登录强制实施运行 SQL Server 的计算机的 Windows 密码策略。 默认值为 ON。

解锁

仅适用于 SQL Server 登录名。 指定应解锁锁定的登录名。

注解

当CHECK_POLICY设置为 ON 时,无法使用 HASHED 参数。

当CHECK_POLICY更改为 ON 时,会发生以下行为:

  • 密码历史记录使用当前密码哈希的值进行初始化。

当CHECK_POLICY更改为 OFF 时,会发生以下行为:

  • CHECK_EXPIRATION也设置为 OFF。
  • 已清除密码历史记录。
  • 重置 lockout_time 的值。

如果指定 MUST_CHANGE,则 CHECK_EXPIRATION 和 CHECK_POLICY 必须设置为 ON。 否则,该语句将失败。

如果CHECK_POLICY设置为 OFF,则无法将CHECK_EXPIRATION设置为 ON。 一个 ALTER LOGIN 包含这些选项组合的陈述失败。

不能将 ALTER_LOGIN 与 DISABLE 参数一起使用来拒绝对 Windows 组的访问。 这是设计造成的。 例如,ALTER_LOGIN [domain\group] DISABLE 返回以下错误消息:

"Msg 15151, Level 16, State 1, Line 1 "Cannot alter the login '*Domain\Group*', because it doesn't exist or you don't have permission."

在 SQL 数据库中,对连接进行身份验证所需的登录数据和服务器级防火墙规则会临时缓存在每个数据库中。 此缓存定期刷新。 若要强制刷新身份验证缓存并确保数据库具有最新版本的登录表,请执行 DBCC FLUSHAUTHCACHE。

Permissions

需要更改任何 LOGIN 许可。

如果使用该 CREDENTIAL 选项,也需要更改任何 CREDENTIAL 权限。

如果所更改的登录名是 sysadmin 固定服务器角色或 CONTROL SERVER 权限的被授权者的成员,则进行以下更改时也需要 CONTROL SERVER 权限:

  • 重置密码而不提供旧密码。
  • 启用MUST_CHANGE、CHECK_POLICY或CHECK_EXPIRATION。
  • 更改登录名。
  • 启用或禁用登录名。
  • 将登录名映射到其他凭据。

主体可以更改其自己的登录名的密码、默认语言和默认数据库。

示例

这些示例还包括使用其他 SQL 产品的示例。 查看支持哪些以前的参数。

A. 启用禁用的登录名

以下示例启用登录 Mary5。

ALTER LOGIN Mary5 ENABLE;

B. 更改登录名的密码

以下示例将登录名 Mary5 的密码更改为强密码。

ALTER LOGIN Mary5 WITH PASSWORD = '<password>';

C. 更改登录名

以下示例将登录名 Mary5 更改为 John2。

ALTER LOGIN Mary5 WITH NAME = John2;

D. 将登录名映射到凭据

以下示例将登录名 John2 映射到凭据 Custodian04。

ALTER LOGIN John2 WITH CREDENTIAL = Custodian04;

E. 将登录名映射到可扩展密钥管理凭据

以下示例将登录名 Mary5 映射到 EKM 凭据 EKMProvider1。

适用于:SQL Server。

ALTER LOGIN Mary5 ADD CREDENTIAL EKMProvider1;
GO

F. 解锁登录名

若要解锁 SQL Server 登录名,请执行以下语句,将 **** 替换为所需的帐户密码。

ALTER LOGIN [Mary5] WITH PASSWORD = '****' UNLOCK;
GO

若要在不更改密码的情况下解锁登录名,请关闭检查策略,然后再次打开。

ALTER LOGIN [Mary5] WITH CHECK_POLICY = OFF;

ALTER LOGIN [Mary5] WITH CHECK_POLICY = ON;
GO

G. 使用 HASHED 更改登录名的密码

以下示例将 TestUser 登录名的密码更改为已哈希值。

适用于:SQL Server。

ALTER LOGIN TestUser WITH PASSWORD = 0x01000CF35567C60BFB41EBDE4CF700A985A13D773D6B45B90900 HASHED;
GO