win_share - Управление общими ресурсами Windows
Обзор
- Добавление, изменение или удаление общих ресурсов Windows и установка разрешений на доступ.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- Поскольку этот модуль использует новые командлеты, такие как New-SmbShare, он может работать только на Windows 8 / Windows 2012 и более поздних версиях.
- Это связано с использованием поставщика WMI MSFT_SmbShare https://msdn.microsoft.com/en-us/library/hh830471, который был добавлен только в этих версиях Windows.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| caching_mode (добавлено в 2.3) |
| Устанавливает режим кэширования для этого общего ресурса. |
| change | Укажите список пользователей, которым следует предоставить чтение и запись на общий ресурс, разделенные запятыми. | |
| deny | Укажите список пользователей, которым следует запретить доступ, независимо от предполагаемого доступа к общему ресурсу, разделенные запятыми. | |
| description | Описание общего ресурса. | |
| encrypt bool (добавлено в 2.4) |
| Устанавливает, следует ли шифровать трафик к общему ресурсу. |
| full | Укажите список пользователей, которым следует предоставить полный доступ к общему ресурсу, разделенные запятыми. | |
| list bool |
| Указывает, следует ли разрешить или запретить просмотр файлов, если пользователю нет разрешения на доступ к общему ресурсу. |
| name обязательно | Имя общего ресурса. | |
| path обязательно | Директория общего ресурса. | |
| read | Укажите список пользователей, которым следует предоставить чтение на общий ресурс, разделенные запятыми. | |
| state |
| Укажите, следует ли добавить present или удалить absent указанный общий ресурс. |
Примеры
# Playbook example
# Add share and set permissions
---
- name: Add secret share
win_share:
name: internal
description: top secret share
path: C:\shares\internal
list: no
full: Administrators,CEO
read: HR-Global
deny: HR-External
- name: Add public company share
win_share:
name: company
description: top secret share
path: C:\shares\company
list: yes
full: Administrators,CEO
read: Global
- name: Remove previously added share
win_share:
name: internal
state: absent
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращено | Описание |
|---|---|---|
| actions список | успех | Список командлетов действий, которые были выполнены модулем. Пример: ['New-SmbShare -Name share -Path C:\\temp'] |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Техническое обслуживание
Этот модуль помечен как основной, что означает, что он поддерживается командой Ansible Core. Дополнительную информацию см. в Разделе поддержки и технического обслуживания модулей.
Список других модулей, также поддерживаемых командой Ansible Core, см. здесь.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний
Автор
- Hans-Joachim Kliemeck (@h0nIg)
- David Baumann (@daBONDi)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
© 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_share_module.html
