Модуль ansible.windows.win_mapped_drive — сопоставление сетевых дисков для пользователей
Примечание
Этот модуль входит в коллекцию ansible.windows (версия 3.6.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install ansible.windows.
Чтобы использовать её в плейбуке, укажите: ansible.windows.win_mapped_drive.
Добавлено в ansible.windows 2.7.0
Краткое описание
- Позволяет изменять сопоставленные сетевые диски для отдельных пользователей.
- Также поддерживает конечные точки WebDAV в формате UNC.
- Хотя этот модуль позволяет управлять сопоставленными дисками, использовать их в последующих задачах Ansible не получится. Сопоставленные диски доступны только при интерактивном входе, например через RDP, но не при сетевом входе через WinRM или SSH, которые Ansible использует для выполнения задач.
Параметры
Параметр | Комментарии |
|---|---|
letter string / обязательный | Буква диска, которому будет сопоставлен сетевой путь. Эта буква не должна быть уже занята в Windows. |
password string | Пароль для Он никогда не сохраняется вместе с сопоставленным диском. Чтобы сохранить имя пользователя и пароль для узла, используйте модуль ansible.windows.win_credential. |
path path | Путь UNC, которому будет сопоставлен диск. Если указан путь WebDAV, он всё равно должен быть в формате UNC Чтобы указать путь WebDAV Этот параметр обязателен, если Если Если |
state string | Если Если Варианты:
|
username string | Имя пользователя, используемое при проверке первоначального подключения. Оно никогда не сохраняется вместе с сопоставленным диском. Для сохранения имени пользователя и пароля для узла используйте модуль ansible.windows.win_credential. Этот параметр необходим, если для сопоставленного диска требуется аутентификация с использованием пользовательских учётных данных, а become или CredSSP использовать нельзя. Если используется become или CredSSP, вместо них автоматически будут использоваться учётные данные, сохранённые с помощью ansible.windows.win_credential. |
Примечания
Примечание
- Этот модуль нельзя использовать для доступа к сопоставленному диску из другой задачи Ansible. Диски, сопоставленные с помощью этого модуля, доступны только при интерактивном входе пользователя через консоль или RDP.
- Если для удалённого пути требуется аутентификация, рекомендуется запускать этот модуль с become или CredSSP.
- При использовании become или CredSSP задача получит доступ ко всем локальным учётным данным, сохранённым в хранилище учётных данных пользователя.
- Если become или CredSSP недоступны, параметры username и password можно использовать для первоначальной аутентификации, но эти данные не сохраняются.
- Чтобы модуль мог сопоставлять пути WebDAV, необходимо установить компонент клиента WebDAV. Он установлен по умолчанию в настольных выпусках Windows, но на узлах Windows Server необходимо установить компонент
WebDAV-Redirectorс помощью ansible.windows.win_feature.
См. также
См. также
- ansible.windows.win_credential
-
Управляет учётными данными Windows в диспетчере учётных данных.
Примеры
- name: Create a mapped drive under Z
ansible.windows.win_mapped_drive:
letter: Z
path: \\domain\appdata\accounting
- name: Delete any mapped drives under Z
ansible.windows.win_mapped_drive:
letter: Z
state: absent
- name: Only delete the mapped drive Z if the paths match (error is thrown otherwise)
ansible.windows.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
ansible.windows.win_credential:
name: server
type: domain_password
username: username@DOMAIN
secret: Password01
state: present
- name: Create a mapped drive that requires authentication
ansible.windows.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: true
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
ansible.windows.win_mapped_drive:
letter: M
path: \\SERVER\C$
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
ansible.windows.win_mapped_drive:
letter: W
path: \\live.sysinternals.com@SSL\tools # https://live.sysinternals.com/tools
state: present
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ansible/windows/win_mapped_drive_module.html