ansible.builtin.user – Ejemplo de administración de cuentas de usuario

Nota

Este módulo es parte de ansible-base e incluido en todas las instalaciones de Ansible. En la mayoría de los casos, puede utilizar el nombre de usuario corto del módulo incluso sin especificar el collections: palabra clave. A pesar de eso, le recomendamos que utilice el FQCN para facilitar la vinculación a la documentación del módulo y evitar conflictos con otras colecciones que puedan tener el mismo nombre de módulo.

Nuevo en la versión 0.2: de ansible.builtin

• Sinopsis
• Parámetros
• Notas
• Ver también
• Ejemplos de
• Valores devueltos

Sinopsis

• Administre cuentas de usuario y atributos de usuario.
• Para los destinos de Windows, use el ansible.windows.win_user módulo en su lugar.

Parámetros

Notas

Nota

• Existen requisitos específicos por plataforma sobre las utilidades de gestión de usuarios. Sin embargo, generalmente vienen preinstalados con el sistema y Ansible requerirá que estén presentes en tiempo de ejecución. Si no es así, se mostrará un mensaje de error descriptivo.
• En las plataformas SunOS, el archivo de sombra se respalda automáticamente ya que este módulo lo edita directamente. En otras plataformas, el archivo de sombra está respaldado por las herramientas subyacentes utilizadas por este módulo.
• En macOS, este módulo utiliza dscl para crear, modificar y eliminar cuentas. dseditgroup se utiliza para modificar la pertenencia a un grupo. Las cuentas se ocultan de la ventana de inicio de sesión modificando /Library/Preferences/com.apple.loginwindow.plist.
• En FreeBSD, este módulo utiliza pw useradd y chpass crear, pw usermod y chpass Modificar, pw userdel retirar, pw lock para bloquear, y pw unlock para desbloquear cuentas.
• En todas las demás plataformas, este módulo utiliza useradd crear, usermod modificar, y userdel para eliminar cuentas.
• Apoyos check_mode.

Ver también

Ver también

ansible.posix.authorized_key

La documentación oficial sobre el ansible.posix.authorized_key módulo.

ansible.builtin.group

La documentación oficial sobre el ansible.builtin.group módulo.

ansible.windows.win_user

La documentación oficial sobre el ansible.windows.win_user módulo.

Ejemplos de

-name: Add the user 'johnd' with a specific uid and a primary group of 'admin'
  ansible.builtin.user:name: johnd
    comment: John Doe
    uid:1040group: admin

-name: Add the user 'james' with a bash shell, appending the group 'admins' and 'developers' to the user's groups
  ansible.builtin.user:name: james
    shell: /bin/bash
    groups: admins,developers
    append: yes

-name: Remove the user 'johnd'
  ansible.builtin.user:name: johnd
    state: absent
    remove: yes

-name: Create a 2048-bit SSH key for user jsmith in ~jsmith/.ssh/id_rsa
  ansible.builtin.user:name: jsmith
    generate_ssh_key: yes
    ssh_key_bits:2048ssh_key_file: .ssh/id_rsa

-name: Added a consultant whose account you want to expire
  ansible.builtin.user:name: james18
    shell: /bin/zsh
    groups: developers
    expires:1422403387-name: Starting at Ansible 2.6, modify user, remove expiry time
  ansible.builtin.user:name: james18
    expires:-1-name: Set maximum expiration date for password
  user:name: ram19
    password_expire_max:10-name: Set minimum expiration date for password
  user:name: pushkar15
    password_expire_min:5

Valores devueltos

Los valores de retorno comunes están documentados aquí, los siguientes son los campos exclusivos de este módulo:

Autores

• Esteban Fromm (@sfromm)