win_mapped_drive – Создание сетевых подключений к дискам для пользователей

Новая версия с 2.4.

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

Обзор

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

Параметры

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

Примечания

Примечание

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

См. также

win_credential – Управление учетными данными Windows в диспетчере учетных данных: Официальная документация модуля win_credential.

Примеры

- 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 }}'

# This should only be required for Windows Server OS'
- name: Ensure WebDAV client feature is installed
  win_feature:
    name: WebDAV-Redirector
    state: present
  register: webdav_feature

- name: Reboot after installing WebDAV client feature
  win_reboot:
  when: webdav_feature.reboot_required

- name: Map the HTTPS WebDAV location
  win_mapped_drive:
    letter: W
    path: \\live.sysinternals.com@SSL\tools  # https://live.sysinternals.com/tools
    state: present

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [preview]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.9/modules/win_mapped_drive_module.html