ansible.builtin.win_user (v2.3.0.0-1) — module

Install Ansible via pip

Install with pip install ansible==2.3.0.0.post1

Description

Manages local Windows user accounts

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Ensure user bob is present
  win_user:
    name: bob
    password: B0bP4ssw0rd
    state: present
    groups:
      - Users

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Ensure user bob is absent
  win_user:
    name: bob
    state: absent

Inputs

    
name:
    description:
    - Name of the user to create, remove or modify.
    required: true

state:
    aliases: []
    choices:
    - present
    - absent
    - query
    default: present
    description:
    - When C(present), creates or updates the user account.  When C(absent), removes the
      user account if it exists.  When C(query) (new in 1.9), retrieves the user account
      details without making any changes.
    required: false

groups:
    description:
    - Adds or removes the user from this comma-separated lis of groups, depending on the
      value of I(groups_action). When I(groups_action) is C(replace) and I(groups) is
      set to the empty string ('groups='), the user is removed from all groups.
    required: false
    version_added: '1.9'
    version_added_collection: ansible.builtin

fullname:
    default: null
    description:
    - Full name of the user
    required: false
    version_added: '1.9'
    version_added_collection: ansible.builtin

password:
    default: null
    description:
    - Optionally set the user's password to this (plain text) value.
    required: false

description:
    default: null
    description:
    - Description of the user
    required: false
    version_added: '1.9'
    version_added_collection: ansible.builtin

groups_action:
    choices:
    - replace
    - add
    - remove
    default: replace
    description:
    - If C(replace), the user is added as a member of each group in I(groups) and removed
      from any other groups.  If C(add), the user is added to each group in I(groups)
      where not already a member.  If C(remove), the user is removed from each group in
      I(groups).
    required: false
    version_added: '1.9'
    version_added_collection: ansible.builtin

account_locked:
    choices:
    - 'no'
    default: null
    description:
    - C(no) will unlock the user account if locked.
    required: false
    version_added: '1.9'
    version_added_collection: ansible.builtin

update_password:
    choices:
    - always
    - on_create
    default: always
    description:
    - C(always) will update passwords if they differ.  C(on_create) will only set the
      password for newly created users.
    required: false
    version_added: '1.9'
    version_added_collection: ansible.builtin

account_disabled:
    choices:
    - 'yes'
    - 'no'
    default: null
    description:
    - C(yes) will disable the user account.  C(no) will clear the disabled flag.
    required: false
    version_added: '1.9'
    version_added_collection: ansible.builtin

password_expired:
    choices:
    - 'yes'
    - 'no'
    default: null
    description:
    - C(yes) will require the user to change their password at next login. C(no) will
      clear the expired password flag.
    required: false
    version_added: '1.9'
    version_added_collection: ansible.builtin

password_never_expires:
    choices:
    - 'yes'
    - 'no'
    default: null
    description:
    - C(yes) will set the password to never expire.  C(no) will allow the password to
      expire.
    required: false
    version_added: '1.9'
    version_added_collection: ansible.builtin

user_cannot_change_password:
    choices:
    - 'yes'
    - 'no'
    default: null
    description:
    - C(yes) will prevent the user from changing their password.  C(no) will allow the
      user to change their password.
    required: false
    version_added: '1.9'
    version_added_collection: ansible.builtin