Si encuentras algo que no comprendes puedes dejarlo en los comentarios y te ayudaremos rápidamente.
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 |
|
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)
Te invitamos a añadir valor a nuestra información contribuyendo tu veteranía en los informes.
¡Haz clic para puntuar esta entrada!
(Votos: 0 Promedio: 0)