win_mapped_drive - настройка сетевого диска для пользователя
Новое в версии 2.4.
Описание
- Позволяет изменять сопоставленные сетевые диски для отдельных пользователей.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| letter обязательно | Буква сетевого пути, которому нужно сопоставить диск. Эта буква не должна уже использоваться в Windows. | |
| password | Пароль для username. | |
| path | UNC-путь, которому нужно сопоставить диск. Это необходимо, если state=present. Если state=absent и путь не задан, модуль удалит сопоставленный диск независимо от целевого объекта.Если state=absent и путь задан, модуль выдаст ошибку, если путь не соответствует целевому объекту сопоставленного диска. | |
| state |
| Если state=present обеспечит существование сопоставленного диска.Если state=absent обеспечит отсутствие сопоставленного диска. |
| username | Учетные данные для сопоставления диска. Имя пользователя ОБЯЗАТЕЛЬНО должно включать домен или имя сервера, например, SERVER\user. См. пример для получения дополнительной информации. |
Примечания
Примечание
- Этот модуль может только сопоставить сетевой диск для текущего выполняемого пользователя и не позволяет задать диск по умолчанию для всех пользователей системы. Для достижения этой цели используйте другие инструменты Microsoft, такие как GPO.
- Этот модуль нельзя использовать для доступа к сопоставленному диску в другой задаче 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
Статус
Этот модуль помечен как предварительный просмотр, что означает, что интерфейс не гарантируется обратной совместимостью.
Автор
- 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.5/modules/win_mapped_drive_module.html
