lowlydba.sqlserver.login 模块 – 配置目标 SQL Server 实例的登录

注意

此模块是 lowlydba.sqlserver 集合（版本 2.3.4）的一部分。

如果您使用的是 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install lowlydba.sqlserver。您需要进一步的要求才能使用此模块，请参阅 要求 了解详细信息。

要在 playbook 中使用它，请指定：lowlydba.sqlserver.login。

lowlydba.sqlserver 0.1.0 中的新功能

概要

  • 在 SQL Server 实例上创建、修改或删除 Windows 或 SQL 身份验证登录。

要求

在执行此模块的主机上需要以下要求。

参数

参数

注释

default_database

字符串

登录的默认数据库。

enabled

布尔值

在 lowlydba.sqlserver 0.4.0 中添加

登录是否启用或禁用。

选项

  • false

  • true ←（默认）

language

字符串

登录的默认语言。仅在创建新登录时使用，而不是在修改现有登录时使用。

login

字符串 / 必需

要配置的登录名。

password

字符串

登录的密码，如果是 SQL 身份验证登录。

password_expiration_enabled

布尔值

强制执行密码过期策略。需要 *password_policy_enforced=true*。

选项

  • false

  • true

password_must_change

布尔值

强制用户在下次登录时必须更改密码。

指定时将强制执行 *password_expiration_enabled* 和 *password_policy_enforced*，因为它们是必需的。

选项

  • false

  • true

password_policy_enforced

布尔值

强制执行密码复杂性策略。

选项

  • false

  • true

sid

字符串

在 lowlydba.sqlserver 2.1.0 中添加

提供在创建帐户时应使用的显式 SID。

skip_password_reset

布尔值

在 lowlydba.sqlserver 2.3.0 中添加

如果登录存在且设置了 *password*，则跳过密码重置。

选项

  • false ←（默认）

  • true

sql_instance

字符串 / 必需

要修改的 SQL Server 实例。

sql_password

字符串

SQL 身份验证的密码。

sql_username

字符串

SQL 身份验证的用户名。

state

字符串

对象是否应该 present 或 absent。

选项

  • "present" ←（默认）

  • "absent"

属性

属性

支持

描述

check_mode

支持： 完全

可以在 check_mode 中运行并返回更改状态预测，而无需修改目标。

platform

平台： 全部

可以操作的目标操作系统/系列。

注释

注意

  • 如果提供密码，模块将始终返回更改。

示例

- name: Create a login
  lowlydba.sqlserver.login:
    sql_instance: sql-01.myco.io
    login: TheIntern
    password: ReallyComplexStuff12345!

- name: Disable a login
  lowlydba.sqlserver.login:
    sql_instance: sql-01.myco.io
    login: TheIntern
    enabled: false

返回值

常见的返回值记录在 此处，以下是此模块特有的字段

键

描述

数据

字典

来自 New-DbaLogin、Set-DbaLogin 或 Remove-DbaLogin 函数的输出。

返回： 成功，但不在 check_mode 中。

作者

  • John McCall (@lowlydba)