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

Новое в версии 1.7.

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Поддержка
- Автор

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
account_disabled bool (добавлено в 1.9)	Варианты: no yes	`yes` отключит учетную запись пользователя. `no` сбросит флаг отключения.
account_locked (добавлено в 1.9)	Варианты: no	`no` разблокирует учетную запись пользователя, если она заблокирована.
description (добавлено в 1.9)		Описание пользователя.
fullname (добавлено в 1.9)		Полное имя пользователя.
groups (добавлено в 1.9)		Добавляет или удаляет пользователя из этого списка групп, разделенных запятыми, в зависимости от значения groups_action. Когда groups_action — `replace`, а groups установлено в пустую строку ('groups='), пользователь удаляется из всех групп.
groups_action (добавлено в 1.9)	Варианты: add replace ← remove	Если `add`, пользователь добавляется в каждую группу в groups, если он в ней ещё не состоит. Если `replace`, пользователь добавляется как член каждой группы в groups и удаляется из всех других групп. Если `remove`, пользователь удаляется из каждой группы в groups.
name обязательно		Имя пользователя для создания, удаления или изменения.
password		По желанию можно установить пароль пользователя в данном (текстовом) значении.
password_expired bool (добавлено в 1.9)	Варианты: no yes	`yes` потребует смены пароля пользователем при следующей попытке входа. `no` сбросит флаг истекшего пароля.
password_never_expires bool (добавлено в 1.9)	Варианты: no yes	`yes` установит пароль так, чтобы он никогда не истекал. `no` позволит паролю истечь.
state	Варианты: absent present ← query	В режиме `absent`, удаляет учетную запись пользователя, если она существует. В режиме `present`, создает или обновляет учетную запись пользователя. В режиме `query` (новое в 1.9), извлекает данные учетной записи пользователя без внесения изменений.
update_password (добавлено в 1.9)	Варианты: always ← on_create	`always` обновит пароли, если они отличаются. `on_create` установит пароль только для вновь созданных пользователей.
user_cannot_change_password bool (добавлено в 1.9)	Варианты: no yes	`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, членами которых является пользователь. Пример: [{'name': 'Администраторы', 'path': 'WinNT://WORKGROUP/USER-PC/Администраторы'}]
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, что означает, что сотрудники, отвечающие за этот модуль, гарантируют, что не будут вноситься несовместимые со старыми версиями изменения в интерфейс.

Техническое обслуживание

Этот модуль помечен как core, что означает, что его обслуживает команда Ansible Core Team. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, которые также обслуживает команда Ansible Core Team, см. здесь.

Поддержка

Дополнительную информацию о поддержке данного модуля компанией 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.6/modules/win_user_module.html