Class: Ansible::Ruby::Modules::Win_user

Inherits:
Base show all
Defined in:
lib/ansible/ruby/modules/generated/core/windows/win_user.rb

Overview

Manages local Windows user accounts

Instance Method Summary collapse

Methods inherited from Base

#ansible_name, #to_h

Methods inherited from Ansible::Ruby::Models::Base

attr_option, attr_options, attribute, #initialize, remove_existing_validations, #to_h, validates

Constructor Details

This class inherits a constructor from Ansible::Ruby::Models::Base

Instance Method Details

#account_disabled ⇒ :yes, ...

Returns C(yes) will disable the user account. C(no) will clear the disabled flag.

Returns:

  • (:yes, :no, nil) —

    C(yes) will disable the user account. C(no) will clear the disabled flag.



40
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 40

attribute :account_disabled

#account_locked ⇒ :no?

Returns C(no) will unlock the user account if locked.

Returns:

  • (:no, nil) —

    C(no) will unlock the user account if locked.



44
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 44

attribute :account_locked

#description ⇒ Object?

Returns Description of the user.

Returns:

  • (Object, nil) —

    Description of the user



18
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 18

attribute :description

#fullname ⇒ Object?

Returns Full name of the user.

Returns:

  • (Object, nil) —

    Full name of the user



15
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 15

attribute :fullname

#groups ⇒ Object?

Returns 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.

Returns:

  • (Object, nil) —

    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.



48
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 48

attribute :groups

#groups_action ⇒ :replace, ...

Returns 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).

Returns:

  • (:replace, :add, :remove, nil) —

    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).



51
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 51

attribute :groups_action

#name ⇒ String

Returns Name of the user to create, remove or modify.

Returns:

  • (String) —

    Name of the user to create, remove or modify.



11
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 11

attribute :name

#password ⇒ Object?

Returns Optionally set the user’s password to this (plain text) value.

Returns:

  • (Object, nil) —

    Optionally set the user’s password to this (plain text) value.



21
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 21

attribute :password

#password_expired ⇒ :yes, ...

Returns C(yes) will require the user to change their password at next login. C(no) will clear the expired password flag.

Returns:

  • (:yes, :no, nil) —

    C(yes) will require the user to change their password at next login. C(no) will clear the expired password flag.



28
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 28

attribute :password_expired

#password_never_expires ⇒ :yes, ...

Returns C(yes) will set the password to never expire. C(no) will allow the password to expire.

Returns:

  • (:yes, :no, nil) —

    C(yes) will set the password to never expire. C(no) will allow the password to expire.



32
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 32

attribute :password_never_expires

#state ⇒ :present, ...

Returns 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.

Returns:

  • (:present, :absent, :query, nil) —

    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.



55
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 55

attribute :state

#update_password ⇒ :always, ...

Returns C(always) will update passwords if they differ. C(on_create) will only set the password for newly created users.

Returns:

  • (:always, :on_create, nil) —

    C(always) will update passwords if they differ. C(on_create) will only set the password for newly created users.



24
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 24

attribute :update_password

#user_cannot_change_password ⇒ :yes, ...

Returns C(yes) will prevent the user from changing their password. C(no) will allow the user to change their password.

Returns:

  • (:yes, :no, nil) —

    C(yes) will prevent the user from changing their password. C(no) will allow the user to change their password.



36
 
# File 'lib/ansible/ruby/modules/generated/core/windows/win_user.rb', line 36

attribute :user_cannot_change_password