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, пользователь добавляется как член каждой группы в groups и удаляется из всех других групп. Если add, пользователь добавляется в каждую группу в groups, где он еще не член. Если remove, пользователь удаляется из каждой группы в groups. |
| name обязательно | Имя пользователя для создания, удаления или изменения. | |
| password | Значение по умолчанию: Нет | Можно задать пароль пользователя (в виде простого текста). |
| password_expired (добавлено в 1.9) |
Нет | yes потребует от пользователя сменить пароль при следующей авторизации. no сбросит флаг истечения срока действия пароля. |
| password_never_expires (добавлено в 1.9) |
Нет | yes установит пароль, который никогда не истекает. no позволит паролю истечь. |
| state |
| При значении present, создает или обновляет учетную запись пользователя. При значении absent, удаляет учетную запись пользователя, если она существует. При значении query (новая функция в 1.9), получает данные учетной записи пользователя без внесения изменений. |
| update_password (добавлено в 1.9) |
| always обновит пароли, если они отличаются. on_create установит пароль только для вновь созданных пользователей. |
| user_cannot_change_password (добавлено в 1.9) |
Нет | yes запретит пользователю изменять свой пароль. no позволит пользователю изменить свой пароль. |
Примечания
Примечание
- Для платформ, отличных от Windows, используйте модуль user вместо этого.
Примеры
- 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 | учетная запись существует | Отключена ли учетная запись пользователя. |
| account_locked bool | учетная запись существует | Заблокирована ли учетная запись пользователя. |
| description str | учетная запись существует | Описание, заданное для пользователя. Пример: Имя пользователя для тестирования |
| fullname str | учетная запись существует | Полное имя, заданное для пользователя. Пример: Имя пользователя для тестирования |
| groups список | учетная запись существует | Список групп и их пути ADSI, членами которых является пользователь. Пример: [{'path': 'WinNT://WORKGROUP/USER-PC/Administrators', 'name': 'Administrators'}] |
| name str | всегда | Имя пользователя Пример: имя_пользователя |
| password_expired bool | учетная запись существует | Истек срок действия пароля? |
| password_never_expires bool | учетная запись существует | Пароль установлен на бессрочное использование? Пример: True |
| path str | учетная запись существует | Путь ADSI для пользователя. Пример: WinNT://WORKGROUP/USER-PC/имя_пользователя |
| sid str | учетная запись существует | SID пользователя. Пример: S-1-5-21-3322259488-2828151810-3939402796-1001 |
| user_cannot_change_password bool | учетная запись существует | Может ли пользователь сменить свой собственный пароль? |
Статус
Этот модуль помечен как stableinterface, что означает, что разработчики этого модуля гарантируют, что не будут вноситься несовместимые с предыдущими версиями изменения интерфейса.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией Red Hat можно найти в этой статье базы знаний
Автор
- Paul Durivage (@angstwad)
- Chris Church (@cchurch)
Подсказка
Если вы заметили какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/win_user_module.html
