win_user_profile – Управляет профилями пользователей Windows
Новая версия 2.8.
Описание
- Используется для создания или удаления профилей пользователей на хосте Windows.
- Это можно использовать для создания профиля перед входом пользователя в систему или удаления профиля при удалении учетной записи пользователя.
- Профиль можно создать как для локальной, так и для доменной учетной записи.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| name строка | Указывает базовое имя для пути профиля. Когда state равно present это используется для создания профиля для username по определенному пути внутри каталога профиля.Это нельзя использовать для указания пути вне каталога профиля, но оно определяет папку(и) внутри этого каталога. Если профиль для другого пользователя уже существует по этому же пути, Windows автоматически добавляет 3-значный инкрементный номер. Когда state равно absent и username не задано, модуль удалит все профили, указывающие на путь профиля, определяемый этим значением.Это полезно, если учетная запись больше не существует, но профиль все еще остается. | |
| remove_multiple логическое значение |
| Когда state равно absent и значение name соответствует нескольким профилям, модуль завершится с ошибкой.Установите это значение в yes чтобы заставить модуль удалить все найденные профили. |
| state строка |
| Обеспечит существование профиля при установке в present. При создании профиля параметр username должен быть установлен на корректную учетную запись. Удалит профиль(и) при установке в absent. При удалении профиля, либо username должен быть установлен на корректную учетную запись, либо name устанавливается на базовое имя профиля. |
| username - | Имя учетной записи идентификатора безопасности (SID) для профиля. Это должно быть установлено, когда state равно present и должно быть корректной учетной записью или SID корректной учетной записи.Когда state равно absent, это все еще должна быть корректная учетная запись, но SID может быть SID удаленного пользователя. |
См. также
См. также
- win_user – Управляет локальными учетными записями пользователей Windows
- Официальная документация модуля win_user.
- win_domain_user – Управляет учетными записями пользователей Windows Active Directory
- Официальная документация модуля win_domain_user.
Примеры
- name: Create a profile for an account
win_user_profile:
username: ansible-account
state: present
- name: Create a profile for an account at C:\Users\ansible
win_user_profile:
username: ansible-account
name: ansible
state: present
- name: Remove a profile for a still valid account
win_user_profile:
username: ansible-account
state: absent
- name: Remove a profile for a deleted account
win_user_profile:
name: ansible
state: absent
- name: Remove a profile for a deleted account based on the SID
win_user_profile:
username: S-1-5-21-3233007181-2234767541-1895602582-1305
state: absent
- name: Remove multiple profiles that exist at the basename path
win_user_profile:
name: ansible
state: absent
remove_multiple: yes
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| path строка | всегда | Полный путь к профилю для учетной записи. Будет пустым, если state=absent и профиль не был удален.Пример: C:\Users\ansible |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Jordan Borean (@jborean93)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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_profile_module.html
