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 |
| Установите CachingMode для этой общей папки. |
| change - | Укажите список пользователей, которые должны получить права чтения и записи для общей папки, разделенные запятыми. | |
| deny - | Укажите список пользователей, которые не должны иметь доступа, независимо от явных разрешений на доступ к общей папке, разделенные запятыми. | |
| description - | Описание общей папки. | |
| encrypt boolean добавлен в 2.4 |
| Устанавливает, нужно ли шифровать трафик к общей папке. |
| full - | Укажите список пользователей, которые должны получить полный доступ к общей папке, разделенные запятыми. | |
| list boolean |
| Укажите, разрешено или запрещено перечисление файлов в случае, если у пользователя нет разрешений на доступ к общей папке. Также известно как перечисление на основе доступа. |
| 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. [ядро]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля компанией Red Hat можно найти в этой статье базы знаний 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.7/modules/win_share_module.html
