win_user – Управляет локальными учетными записями пользователей Windows
Новая в версии 1.7.
Описание
- Управляет локальными учетными записями пользователей Windows.
- Для платформ, отличных от Windows, используйте модуль user вместо этого.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| account_disabled boolean добавлено в 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 |
| Если add, пользователь добавляется в каждую группу в groups, где он ещё не является членом.Если replace, пользователь добавляется как член каждой группы в groups и удаляется из всех других групп.Если remove, пользователь удаляется из каждой группы в groups. |
| name - / обязательно | Имя пользователя для создания, удаления или изменения. | |
| password - | Дополнительно установите пароль пользователя в этом (текстовом) значении. | |
| password_expired boolean добавлено в 1.9 |
| yes потребует от пользователя смены пароля при следующей попытке входа.no сбросит флаг истечения срока действия пароля. |
| password_never_expires boolean добавлено в 1.9 |
| yes установит пароль так, чтобы он никогда не истекал.no позволит паролю истечь. |
| state - |
| В случае absent, удаляет учетную запись пользователя, если она существует.В случае present, создает или обновляет учетную запись пользователя.В случае query (новое в 1.9), получает данные учетной записи пользователя без внесения изменений. |
| update_password - добавлено в 1.9 |
| always обновит пароли, если они отличаются. on_create установит пароль только для вновь созданных пользователей. |
| user_cannot_change_password boolean добавлено в 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 boolean | существует пользователь | Отключена ли учетная запись пользователя. |
| account_locked boolean | существует пользователь | Заблокирована ли учетная запись пользователя. |
| description строка | существует пользователь | Описание, установленное для пользователя. Пример: Имя пользователя для теста |
| fullname строка | существует пользователь | Полное имя, установленное для пользователя. Пример: Тестовое имя пользователя |
| groups список | существует пользователь | Список групп и их пути ADSI, членом которых является пользователь. Пример: [{'name': 'Администраторы', 'path': 'WinNT://WORKGROUP/USER-PC/Administrators'}] |
| name строка | всегда | Имя пользователя Пример: имя_пользователя |
| password_expired boolean | существует пользователь | Истек ли срок действия пароля. |
| password_never_expires boolean | существует пользователь | Установлено ли, что пароль никогда не истекает. Пример: True |
| path строка | существует пользователь | Путь ADSI для пользователя. Пример: WinNT://WORKGROUP/USER-PC/имя_пользователя |
| sid строка | существует пользователь | SID для пользователя. Пример: S-1-5-21-3322259488-2828151810-3939402796-1001 |
| user_cannot_change_password boolean | существует пользователь | Может ли пользователь изменить свой пароль. |
Статус
- В этом модуле гарантируются отсутствие изменений интерфейса, несовместимых со старыми версиями. [stableinterface]
- Этот модуль поддерживается командой разработчиков Ansible Core. [core]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний 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.7/modules/win_user_module.html
