win_user_profile – Manages the Windows user profiles
win_user_profile – Manages the Windows user profiles
New in version 2.8.
Synopsis
- Used to create or remove user profiles on a Windows host.
- This can be used to create a profile before a user logs on or delete a profile when removing a user account.
- A profile can be created for both a local or domain account.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
name string |
Specifies the base name for the profile path. When state is This cannot be used to specify a path outside of the profile directory but rather it specifies a folder(s) within this directory. If a profile for another user already exists at the same path, then a 3 digit incremental number is appended by Windows automatically. When state is This is useful if the account no longer exists but the profile still remains. | |
remove_multiple boolean |
|
When state is Set this value to |
state string |
|
Will ensure the profile exists when set to When creating a profile the username option must be set to a valid account. Will remove the profile(s) when set to When removing a profile either username must be set to a valid account, or name is set to the profile's base name. |
username - |
The account name of security identifier (SID) for the profile. This must be set when state is When state is |
See Also
See also
- win_user – Manages local Windows user accounts
- The official documentation on the win_user module.
- win_domain_user – Manages Windows Active Directory user accounts
- The official documentation on the win_domain_user module.
Examples
- 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
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
path string |
always |
The full path to the profile for the account. This will be null if
Sample: C:\Users\ansible |
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- 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