salt.modules.win_shadow¶

Manage the shadow file

Important

If you feel that Salt should be using this module to manage passwords on a minion, and it is using a different module (or gives an error similar to 'shadow.info' is not available), see here.

salt.modules.win_shadow.info(name)¶

Return information for the specified user This is just returns dummy data so that salt states can work.

Parameters: name (str) -- The name of the user account to show.

CLI Example:

salt '*' shadow.info root

salt.modules.win_shadow.require_password_change(name)¶

Require the user to change their password the next time they log in.

Parameters: name -- The name of the user account to require a password change.
Returns: True if successful. False if unsuccessful.
Return type: bool

CLI Example:

salt '*' shadow.require_password_change <username>

salt.modules.win_shadow.set_expire(name, expire)¶

Set the expiration date for a user account.

Parameters

name -- The name of the user account to edit.
expire -- The date the account will expire.

Returns

True if successful. False if unsuccessful.

Return type

bool

CLI Example:

salt '*' shadow.set_expire <username> 2016/7/1

salt.modules.win_shadow.set_password(name, password)¶

Set the password for a named user.

Parameters

name (str) -- The name of the user account
password (str) -- The new password

Returns

True if successful. False if unsuccessful.

Return type

bool

CLI Example:

salt '*' shadow.set_password root mysecretpassword

salt.modules.win_shadow.unlock_account(name)¶

Unlocks a user account.

Parameters: name -- The name of the user account to unlock.
Returns: True if successful. False if unsuccessful.
Return type: bool

CLI Example:

salt '*' shadow.unlock_account <username>