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

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

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
letter - / обязательно		Буква сетевого пути для сопоставления. Эта буква не должна уже использоваться в Windows.
password -		Пароль для `username`.
path путь		UNC-путь для сопоставления диска. Требуется, если `state=present`. Если `state=absent` и путь не задан, модуль удалит сопоставленный диск независимо от целевого объекта. Если `state=absent` и путь задан, модуль выдаст ошибку, если путь не соответствует целевому объекту сопоставленного диска.
state -	Варианты: absent present ←	Если `present` обеспечит существование сопоставленного диска. Если `absent` обеспечит отсутствие сопоставленного диска.
username -		Учетные данные для сопоставления диска. Имя пользователя ДОЛЖНО включать домен или имя сервера, например SERVER\user, см. пример для получения дополнительной информации.

Примечания

Примечание

Этот модуль может сопоставить сетевой диск только для текущего выполняемого пользователя и не позволяет задать диск по умолчанию для всех пользователей системы. Используйте другие инструменты Microsoft, такие как групповые политики, для достижения этой цели.
Вы не можете использовать этот модуль для доступа к сопоставленному диску в другом задании Ansible, диски, сопоставленные с помощью этого модуля, доступны только при интерактивном входе в систему с пользователем через консоль или RDP.

Примеры

- 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 local credentials
  win_mapped_drive:
    letter: M
    path: \\SERVER\c$
    username: SERVER\Administrator
    password: Password

- name: Create mapped drive with domain credentials
  win_mapped_drive:
    letter: M
    path: \\domain\appdata\it
    username: DOMAIN\IT
    password: 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.7/modules/win_mapped_drive_module.html