Модуль lowlydba.sqlserver.login_role — настройка серверных ролей для имени входа.

Примечание

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

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

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

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

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

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

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

Добавляет или удаляет серверную роль для имени входа.

Перечисленные ниже компоненты необходимы на хосте, на котором выполняется этот модуль.

Модуль PowerShell dbatools

Параметры

Параметр	Комментарии
login строка / обязательный	Имя входа.
server_role строка / обязательный	Серверная роль, назначение которой для имени входа требуется изменить.
sql_instance строка / обязательный	Экземпляр SQL Server, который требуется изменить.
sql_password строка	Пароль для проверки подлинности SQL.
sql_username строка	Имя пользователя для проверки подлинности SQL.
state строка	Следует ли перевести объект в состояние `present` или `absent`. Варианты: `"present"` ← (по умолчанию) `"absent"`

Атрибуты

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

Примеры

- name: Add a user to a fixed server role
  lowlydba.sqlserver.login_role:
    sql_instance: sql-01.myco.io
    login: TheIntern
    server_role: sysadmin

- name: Remove a user from a fixed server role
  lowlydba.sqlserver.login_role:
    sql_instance: sql-01.myco.io
    login: TheIntern
    server_role: sysadmin
    state: absent

- name: Add a user to a custom server role
  lowlydba.sqlserver.login_role:
    sql_instance: sql-01.myco.io
    login: TheIntern
    server_role: demi-admin

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

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

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

Авторы

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/login_role_module.html