community.windows.win_auto_logon – Adds or Sets auto logon registry keys.

Note

This plugin is part of the community.windows collection (version 1.7.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.windows.

To use it in a playbook, specify: community.windows.win_auto_logon.

Synopsis

  • Used to apply auto logon registry setting.

Parameters

Parameter Choices/Defaults Comments
logon_count
integer
The number of times to do an automatic logon.
This count is deremented by Windows everytime an automatic logon is performed.
Once the count reaches 0 then the automatic logon process is disabled.
password
string
Password to be used for automatic login.
Must be set when state=present.
Value of this input will be used as password for username.
While this value is encrypted by LSA it is decryptable to any user who is an Administrator on the remote host.
state
string
    Choices:
  • absent
  • present
Whether the registry key should be present or absent.
username
string
Username to login automatically.
Must be set when state=present.
This can be the Netlogon or UPN of a domain account and is automatically parsed to the DefaultUserName and DefaultDomainName registry properties.

Examples

- name: Set autologon for user1
  community.windows.win_auto_logon:
    username: User1
    password: str0ngp@ssword

- name: Set autologon for abc.com\user1
  community.windows.win_auto_logon:
    username: abc.com\User1
    password: str0ngp@ssword

- name: Remove autologon for user1
  community.windows.win_auto_logon:
    state: absent

- name: Set autologon for user1 with a limited logon count
  community.windows.win_auto_logon:
    username: User1
    password: str0ngp@ssword
    logon_count: 5

Authors

  • Prasoon Karunan V (@prasoonkarunan)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_auto_logon_module.html