Spec-Zone.ru › Ansible

Модуль 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

Пароль для username, используемый при проверке первоначального подключения.

Он никогда не сохраняется вместе с сопоставленным диском. Чтобы сохранить имя пользователя и пароль для узла, используйте модуль ansible.windows.win_credential.

path

path

Путь UNC, которому будет сопоставлен диск.

Если указан путь WebDAV, он всё равно должен быть в формате UNC \\hostname\path, а не URL. Подробнее см. примеры.

Чтобы указать путь WebDAV https, добавьте @SSL после имени узла. Чтобы указать пользовательский порт WebDAV, добавьте @<port num> после @SSL или имени узла в пути UNC, например \\server@SSL@1234 или \\server@1234.

Этот параметр обязателен, если state=present.

Если state=absent и параметр path не задан, модуль удалит сопоставленный диск независимо от целевого пути.

Если state=absent и параметр path задан, модуль выдаст ошибку, если путь не совпадает с целевым путём сопоставленного диска.

state

string

Если present, будет обеспечено наличие сопоставленного диска.

Если absent, будет обеспечено отсутствие сопоставленного диска.

Варианты:

  • "absent"
  • "present" ← (по умолчанию)

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

Авторы

  • Jordan Borean (@jborean93)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API