Nota

Este complemento es parte del colección community.windows (versión 1.2.0).

Para instalarlo use: ansible-galaxy collection install community.windows.

Para usarlo en un libro de jugadas, especifique: community.windows.win_mapped_drive.

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

Sinopsis

  • Le permite modificar unidades de red asignadas para usuarios individuales.
  • También admite puntos finales WebDAV en el formulario UNC.

Parámetros

Parámetro Opciones / Valores predeterminados Comentarios
cartastring / requerido La letra de la ruta de red a la que se va a asignar. Esta letra no debe estar ya en uso con Windows.
contraseñastring La contraseña para username que se utiliza al probar la conexión inicial. Esto nunca se guarda con una unidad asignada, utilice el community.windows.win_credential módulo para conservar un nombre de usuario y contraseña para un host.
senderosendero La ruta UNC para mapear la unidad. Si apunta a una ubicación WebDAV, debe estar en una ruta UNC en el formato \hostnamepath y no una URL, consulte los ejemplos para obtener más detalles. https Ruta de WebDAV, agregar @SSL después del nombre de host. Para especificar un puerto WebDAV personalizado, agregue @ después de la @SSL o parte del nombre de host de la ruta UNC, p. ej. \[email protected]@1234 o \[email protected].Esto es necesario si state=present.Si state=absent y sendero no está configurado, el módulo eliminará la unidad asignada independientemente del destino. state=absent y el sendero está configurado, el módulo arrojará un error si la ruta no coincide con el destino de la unidad asignada.
estadostring
    Opciones:

  • ausente
  • regalo
Si present se asegurará de que exista la unidad asignada. absent se asegurará de que la unidad asignada no exista.
nombre de usuariostring El nombre de usuario que se utiliza al probar la conexión inicial. Nunca se guarda con una unidad asignada, el community.windows.win_credential módulo para conservar un nombre de usuario y contraseña para un host. Esto es necesario si la unidad asignada requiere autenticación con credenciales personalizadas y se convierte, o no se puede utilizar CredSSP. community.windows.win_credential se utilizará automáticamente en su lugar.

Notas

Nota

  • No puede usar este módulo para acceder a una unidad mapeada en otra tarea de Ansible, las unidades mapeadas con este módulo solo son accesibles al iniciar sesión de forma interactiva con el usuario a través de la consola o RDP.
  • Se recomienda ejecutar este módulo con Become o CredSSP cuando la ruta remota requiera autenticación.
  • Al usar Become o CredSSP, la tarea tendrá acceso a las credenciales locales almacenadas en la bóveda del usuario.
  • Si se convierte o CredSSP no está disponible, el nombre de usuario y contraseña Las opciones se pueden utilizar para la autenticación inicial, pero no se conservan.
  • Las rutas de WebDAV deben tener instalada la función de cliente WebDAV para que este módulo asigne esas rutas. Esto se instala de forma predeterminada en las ediciones de escritorio de Windows, pero los hosts de Windows Server deben instalar el WebDAV-Redirector característica usando ansible.windows.win_feature.

Ver también

Ver también

community.windows.win_credential

La documentación oficial sobre el community.windows.win_credential módulo.

Ejemplos de

-name: Create a mapped drive under Z
  community.windows.win_mapped_drive:letter: Z
    path: \domainappdataaccounting

-name: Delete any mapped drives under Z
  community.windows.win_mapped_drive:letter: Z
    state: absent

-name: Only delete the mapped drive Z if the paths match (error is thrown otherwise)
  community.windows.win_mapped_drive:letter: Z
    path: \domainappdataaccounting
    state: absent

-name: Create mapped drive with credentials and save the username and password
  block:-name: Save the network credentials required for the mapped drive
    community.windows.win_credential:name: server
      type: domain_password
      username:[email protected]secret: Password01
      state: present

  -name: Create a mapped drive that requires authentication
    community.windows.win_mapped_drive:letter: M
      path: \SERVERC$
      state: present
  vars:# become is required to save and retrieve the credentials in the tasksansible_become: yes
    ansible_become_method: runas
    ansible_become_user:' ansible_user 'ansible_become_pass:' ansible_password '-name: Create mapped drive with credentials that do not persist on the next logon
  community.windows.win_mapped_drive:letter: M
    path: \SERVERC$
    state: present
    username:' ansible_user 'password:' ansible_password '# This should only be required for Windows Server OS'-name: Ensure WebDAV client feature is installed
  ansible.windows.win_feature:name: WebDAV-Redirector
    state: present
  register: webdav_feature

-name: Reboot after installing WebDAV client feature
  ansible.windows.win_reboot:when: webdav_feature.reboot_required

-name: Map the HTTPS WebDAV location
  community.windows.win_mapped_drive:letter: W
    path: \[email protected]tools  # https://live.sysinternals.com/toolsstate: present

Autores

  • Jordan Borean (@ jborean93)