community.windows.win_mapped_drive – Настройка сетевых дисков для пользователей

Примечание

Этот плагин является частью коллекции community.windows (версия 1.2.0).

Для его установки используйте: ansible-galaxy collection install community.windows.

Для использования в книге задач укажите: community.windows.win_mapped_drive.

Обзор
Параметры
Примечания
См. также
Примеры

Обзор

Позволяет изменять назначенные сетевые диски для отдельных пользователей.
Также поддерживает конечные точки WebDAV в формате UNC.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
letter строка / обязательно		Буква сетевого пути, который нужно назначить. Эта буква не должна уже использоваться в Windows.
password строка		Пароль для `username`, используемый при проверке первоначального подключения. Он никогда не сохраняется вместе с назначенным диском. Используйте модуль community.windows.win_credential для сохранения имени пользователя и пароля для узла.
path путь		Путь UNC, которому нужно назначить диск. Если указано расположение WebDAV, оно должно быть в формате UNC `\\hostname\path`, а не URL. Для получения дополнительных сведений см. примеры. Чтобы указать путь WebDAV с `https`, добавьте `@SSL` после имени хоста. Для указания пользовательского порта WebDAV добавьте `@<port num>` после части пути UNC `@SSL` или имени хоста, например, `\\server@SSL@1234` или `\\server@1234`. Требуется, если `state=present`. Если `state=absent` и path не задан, модуль удалит назначенный диск независимо от целевого объекта. Если `state=absent` и path задан, модуль выдаст ошибку, если путь не соответствует целевому объекту назначенного диска.
state строка	Варианты: absent present ←	Если `present` гарантирует существование назначенного диска. Если `absent` гарантирует отсутствие назначенного диска.
username строка		Имя пользователя, используемое при проверке первоначального подключения. Это никогда не сохраняется вместе с назначенным диском. Используйте модуль community.windows.win_credential для сохранения имени пользователя и пароля для узла. Требуется, если для назначенного диска требуется аутентификация с использованием пользовательских учетных данных и недоступна функция «стать» или CredSSP. Если используется «стать» или CredSSP, любые учетные данные, сохраненные с помощью community.windows.win_credential, будут автоматически использоваться вместо этого.

Примечания

Примечание

Этот модуль не может использоваться для доступа к назначенному диску в другой задаче Ansible. Диски, назначенные с помощью этого модуля, доступны только при интерактивном входе в систему пользователем через консоль или RDP.
Рекомендуется запускать этот модуль с правами «стать» или CredSSP, если удаленный путь требует аутентификации.
При использовании «стать» или CredSSP задача получит доступ к любым локальным учетным данным, сохраненным в хранилище пользователя.
Если «стать» или CredSSP недоступны, можно использовать параметры username и password для первоначальной аутентификации, но они не сохраняются.
Для отображения путей WebDAV в этом модуле должна быть установлена функция клиента WebDAV. Она устанавливается по умолчанию в настольных версиях Windows, но на хостах Windows Server необходимо установить функцию WebDAV-Redirector с помощью ansible.windows.win_feature.

См. также

community.windows.win_credential: Официальная документация по модулю community.windows.win_credential.

Примеры

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

- 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: \\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
    community.windows.win_credential:
      name: server
      type: domain_password
      username: username@DOMAIN
      secret: Password01
      state: present

  - name: Create a mapped drive that requires authentication
    community.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: 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: \\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
  community.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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/windows/win_mapped_drive_module.html