win_user – Управляет локальными учётными записями пользователей Windows

Краткое описание
Параметры
См. также
Примеры
Возвращаемые значения
Статус

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

Управляет локальными учётными записями пользователей Windows.
Для платформ, отличных от Windows, используйте модуль user вместо него.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
account_disabled boolean	Варианты: no yes	`yes` отключит учётную запись пользователя. `no` сбросит флаг отключения.
account_locked -	Варианты: no	`no` разблокирует учётную запись пользователя, если она заблокирована.
description string		Описание пользователя.
fullname string		Полное имя пользователя.
groups -		Добавляет или удаляет пользователя из этого списка групп, разделённых запятыми, в зависимости от значения groups_action. Когда groups_action равно `replace` и groups установлено в пустую строку ('groups='), пользователь удаляется из всех групп.
groups_action string	Варианты: add replace ← remove	Если `add`, пользователь добавляется в каждую группу из списка groups, если он ещё не является членом этой группы. Если `replace`, пользователь добавляется как член каждой группы из списка groups и удаляется из всех других групп. Если `remove`, пользователь удаляется из каждой группы из списка groups.
name string / обязательно		Имя пользователя для создания, удаления или изменения.
password string		Необязательно установить пароль пользователя на это значение (в виде простого текста).
password_expired boolean	Варианты: no yes	`yes` потребует от пользователя сменить пароль при следующей попытке входа. `no` сбросит флаг истечения срока действия пароля.
password_never_expires boolean	Варианты: no yes	`yes` установит пароль, который никогда не истечёт. `no` позволит паролю истечь.
state string	Варианты: absent present ← query	Когда `absent`, удаляет учётную запись пользователя, если она существует. Когда `present`, создаёт или обновляет учётную запись пользователя. Когда `query` (новое в 1.9), получает подробности о пользователе без внесения изменений.
update_password string	Варианты: always ← on_create	`always` обновит пароли, если они отличаются. `on_create` установит пароль только для вновь созданных пользователей.
user_cannot_change_password boolean	Варианты: no yes	`yes` запретит пользователю менять свой пароль. `no` позволит пользователю изменить свой пароль.

См. также

user – Управление учётными записями пользователей: Официальная документация по модулю user.
win_domain_membership – Управление членством в домене/рабочей группе для хоста Windows: Официальная документация по модулю win_domain_membership.
win_domain_user – Управляет учётными записями пользователей в Windows Active Directory: Официальная документация по модулю win_domain_user.
win_group – Добавление и удаление локальных групп: Официальная документация по модулю win_group.
win_group_membership – Управление членством в локальных группах Windows: Официальная документация по модулю win_group_membership.
win_user_profile – Управляет профилями пользователей Windows: Официальная документация по модулю win_user_profile.

Примеры

- 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 string	пользователь существует	Описание, установленное для пользователя. Пример: Имя пользователя для теста
fullname string	пользователь существует	Полное имя, установленное для пользователя. Пример: Тестовое имя пользователя
groups list	пользователь существует	Список групп и их пути ADSI, членами которых является пользователь. Пример: [{'name': 'Администраторы', 'path': 'WinNT://WORKGROUP/USER-PC/Администраторы'}]
name string	всегда	Имя пользователя Пример: имя_пользователя
password_expired boolean	пользователь существует	Истек срок действия пароля.
password_never_expires boolean	пользователь существует	Установлен ли пароль, который никогда не истекает. Пример: True
path string	пользователь существует	Путь ADSI для пользователя. Пример: WinNT://WORKGROUP/USER-PC/имя_пользователя
sid string	пользователь существует	SID для пользователя. Пример: S-1-5-21-3322259488-2828151810-3939402796-1001
user_cannot_change_password boolean	пользователь существует	Может ли пользователь изменить свой пароль.

Статус

Этот модуль гарантирует обратную совместимость изменений интерфейса в будущем. [stableinterface]
Этот модуль поддерживается командой Ansible Core. [core]

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля компанией Red Hat можно найти в этой статье базы знаний Red Hat.

Авторы

Пол Дьюриваж (@angstwad)
Крис Черч (@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.9/modules/win_user_module.html