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:\Пользователи\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.9/modules/win_user_profile_module.html
