win_user — Управление локальными учетными записями пользователей Windows
Новая версия с 1.7.
Описание
- Управление локальными учетными записями пользователей Windows
- Для платформ, отличных от Windows, используйте модуль user вместо этого.
Параметры
| Параметр | Обязательно | Значение по умолчанию | Варианты | Комментарии |
|---|---|---|---|---|
| account_disabled (добавлен в 1.9)
| Нет |
| yes отключит учетную запись пользователя. no сбросит флаг отключения. | |
| account_locked (добавлен в 1.9)
| Нет |
| no разблокирует учетную запись пользователя, если она заблокирована. | |
| description (добавлен в 1.9)
| Нет | Описание пользователя | ||
| fullname (добавлен в 1.9)
| Нет | Полное имя пользователя | ||
| groups (добавлен в 1.9)
| Нет | Добавляет или удаляет пользователя из этого списка групп, разделенных запятыми, в зависимости от значения groups_action. Когда groups_action равен replace, а groups установлено на пустую строку ('groups='), пользователь удаляется из всех групп. | ||
| groups_action (добавлен в 1.9)
| Нет | replace |
| Если replace, пользователь добавляется в члены каждой группы в groups и удаляется из других групп. Если add, пользователь добавляется в каждую группу в groups, если он еще не является её членом. Если remove, пользователь удаляется из каждой группы в groups. |
| name | Да | Имя пользователя для создания, удаления или изменения. | ||
| password | Нет | Факультативно установит пароль пользователя в это (простое) значение. | ||
| password_expired (добавлен в 1.9)
| Нет |
| yes потребует, чтобы пользователь изменил свой пароль при следующей авторизации. no сбросит флаг истечения срока действия пароля. | |
| password_never_expires (добавлен в 1.9)
| Нет |
| yes установит пароль так, чтобы он никогда не истекал. no позволит паролю истечь. | |
| state | Нет | present |
| При значении present, создает или обновляет учетную запись пользователя. При значении absent, удаляет учетную запись пользователя, если она существует. При значении query (новая функция в 1.9), извлекает данные учетной записи пользователя без внесения изменений. |
| update_password (добавлен в 1.9)
| Нет | always |
| always обновит пароли, если они отличаются. on_create установит пароль только для вновь созданных пользователей. |
| user_cannot_change_password (добавлен в 1.9)
| Нет |
| yes запретит пользователю изменение своего пароля. no позволит пользователю изменить свой пароль. |
Примеры
- name: Ensure user bob is present
win_user:
name: bob
password: B0bP4ssw0rd
state: present
groups:
- Users
- name: Ensure user bob is absent
win_user:
name: bob
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| Имя | Описание | Возвращается | Тип | Пример |
|---|---|---|---|---|
| account_disabled | Отключена ли учетная запись пользователя. | пользователь существует | bool | False |
| account_locked | Заблокирован ли пользователь. | пользователь существует | bool | False |
| description | Описание, заданное для пользователя. | пользователь существует | str | Имя пользователя для теста |
| fullname | Полное имя, заданное для пользователя. | пользователь существует | str | Имя пользователя для теста |
| groups | Список групп и их пути ADSI, членами которых является пользователь. | пользователь существует | список | [{'path': 'WinNT://WORKGROUP/USER-PC/Administrators', 'name': 'Администраторы'}] |
| name | Имя пользователя | всегда | str | имя_пользователя |
| password_expired | Истек ли срок действия пароля. | пользователь существует | bool | False |
| password_never_expires | Установлено ли ограничение по истечению срока действия пароля. | пользователь существует | bool | True |
| path | Путь ADSI для пользователя. | пользователь существует | str | WinNT://WORKGROUP/USER-PC/имя_пользователя |
| sid | SID для пользователя. | пользователь существует | str | S-1-5-21-3322259488-2828151810-3939402796-1001 |
| user_cannot_change_password | Может ли пользователь изменить свой пароль. | пользователь существует | bool | False |
Примечания
Примечание
- Для платформ, отличных от Windows, используйте модуль user вместо этого.
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будут вноситься несовместимые изменения в интерфейс.
Информация о техническом обслуживании
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
Для получения помощи в разработке модулей, если это вас интересует, прочтите Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_user_module.html
