ansible / ansible.builtin / v2.9.0 / module / win_mapped_drive Map network drives for users | "added in version" 2.4 of ansible.builtin" Authors: Jordan Borean (@jborean93) preview | supported by communityansible.builtin.win_mapped_drive (v2.9.0) — module
pip
Install with pip install ansible==2.9.0
Allows you to modify mapped network drives for individual users.
- name: Create a mapped drive under Z win_mapped_drive: letter: Z path: \\domain\appdata\accounting
- name: Delete any mapped drives under Z win_mapped_drive: letter: Z state: absent
- name: Only delete the mapped drive Z if the paths match (error is thrown otherwise) win_mapped_drive: letter: Z path: \\domain\appdata\accounting 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 win_credential: name: server type: domain_password username: username@DOMAIN secret: Password01 state: present - name: Create a mapped drive that requires authentication win_mapped_drive: letter: M path: \\SERVER\C$ state: present vars: # become is required to save and retrieve the credentials in the tasks ansible_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 win_mapped_drive: letter: M path: \\SERVER\C$ state: present username: '{{ ansible_user }}' password: '{{ ansible_password }}'
path: description: - The UNC path to map the drive to. - This is required if C(state=present). - If C(state=absent) and I(path) is not set, the module will delete the mapped drive regardless of the target. - If C(state=absent) and the I(path) is set, the module will throw an error if path does not match the target of the mapped drive. type: path state: choices: - absent - present default: present description: - If C(present) will ensure the mapped drive exists. - If C(absent) will ensure the mapped drive does not exist. type: str letter: description: - The letter of the network path to map to. - This letter must not already be in use with Windows. required: true type: str password: description: - The password for C(username) that is used when testing the initial connection. - This is never saved with a mapped drive, use the M(win_credential) module to persist a username and password for a host. type: str username: description: - The username that is used when testing the initial connection. - This is never saved with a mapped drive, the the M(win_credential) module to persist a username and password for a host. - This is required if the mapped drive requires authentication with custom credentials and become, or CredSSP cannot be used. - If become or CredSSP is used, any credentials saved with M(win_credential) will automatically be used instead. type: str