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