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 – Управление учётными записями пользователей Active Directory Windows: Официальная документация модуля 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 список	существует пользователь	Список групп и их путей ADSI, членами которых является пользователь. Пример: [{'name': 'Администраторы', 'path': 'WinNT://WORKGROUP/USER-PC/Administrators'}]
name string	всегда	Имя пользователя Пример: имя_пользователя
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.8/modules/win_user_module.html