Модуль lowlydba.sqlserver.user — настройка пользователя в базе данных

Примечание

Этот модуль входит в коллекцию lowlydba.sqlserver (версия 2.8.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install lowlydba.sqlserver. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: lowlydba.sqlserver.user.

Добавлено в lowlydba.sqlserver 1.1.0

Краткое описание
Требования
Параметры
Атрибуты
Примеры
Возвращаемые значения

Краткое описание

Создаёт, изменяет или удаляет пользователя в базе данных.

Требования

Следующие требования необходимо выполнить на узле, на котором запускается этот модуль.

Модуль PowerShell dbatools

Параметры

Параметр	Комментарии
database string / обязательный	База данных для пользователя.
default_schema string	Схема базы данных по умолчанию для пользователя. По умолчанию: `"dbo"`
external_provider boolean	Указывает, что пользователь предназначен для аутентификации Azure AD. Используется только при создании нового пользователя; для существующего пользователя это значение изменить нельзя. Варианты: `false` `true`
login string / обязательный	Имя учётной записи, с которой связан пользователь.
sql_instance string / обязательный	Экземпляр SQL Server, который нужно изменить.
sql_password string	Пароль для аутентификации SQL.
sql_username string	Имя пользователя для аутентификации SQL.
state string	Следует ли `present` объект или `absent`. Варианты: `"present"` ← (по умолчанию) `"absent"`
username string / обязательный	Имя пользователя.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль можно запускать в режиме check_mode: он сообщит прогнозируемое состояние изменений, не изменяя целевой объект.
platform	Платформы: все	Целевые ОС и семейства ОС, с которыми можно работать.

Примеры

- name: Create a user
  lowlydba.sqlserver.user:
    sql_instance: sql-01.myco.io
    login: TheIntern
    username: TheIntern
    database: InternProject1

- name: Change user's schema
  lowlydba.sqlserver.login:
    sql_instance: sql-01.myco.io
    login: TheIntern
    username: TheIntern
    database: InternProject1
    default_schema: dev

- name: Remove a user
  lowlydba.sqlserver.login:
    sql_instance: sql-01.myco.io
    login: TheIntern
    username: TheIntern
    database: InternProject1
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
data dictionary	Результат выполнения функции `New-DbaDbUser`, `Get-DbaDbUser` или `Remove-DbaDbUser`. Возвращается: при успешном выполнении, но не в режиме check_mode.

Авторы

John McCall (@lowlydba)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/lowlydba/sqlserver/user_module.html