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

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

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

Описание

Позволяет изменять назначенные сетевые диски для отдельных пользователей.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
letter строка / обязательно		Буква сетевого пути, к которому необходимо подключиться. Эта буква не должна быть уже занята в Windows.
password строка		Пароль для `username`, используемый при тестировании первоначального подключения. Этот пароль никогда не сохраняется с назначенным диском. Используйте модуль win_credential для сохранения имени пользователя и пароля для узла.
path путь		UNC-путь для назначения диска. Требуется, если `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 могут быть использованы для первоначальной аутентификации, но они не сохраняются.

См. также

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

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом 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.8/modules/win_mapped_drive_module.html