win_share – Управление общими папками Windows
Описание
- Добавление, изменение или удаление общих папок Windows и установка разрешений доступа.
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, на котором будет выполняться этот модуль.
- Так как этот модуль использует новые командлеты, такие как New-SmbShare, он может работать только на Windows 8 / Windows 2012 или более поздних версиях.
- Это связано с зависимостью от поставщика WMI MSFT_SmbShare https://msdn.microsoft.com/en-us/library/hh830471, который был добавлен только в этих версиях Windows.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| caching_mode строка |
| Установить режим кэширования для этой общей папки. |
| change строка | Указать список пользователей, которым должны быть предоставлены права чтения и записи для общей папки, разделенные запятыми. | |
| deny строка | Указать список пользователей, которым не должны быть предоставлены никакие права доступа, независимо от явных разрешений доступа к общей папке, разделенные запятыми. | |
| description строка | Описание общей папки. | |
| encrypt логическое добавлен в 2.4 |
| Устанавливает, следует ли шифровать трафик в общую папку. |
| full строка | Указать список пользователей, которым необходимо предоставить полный доступ к общей папке, разделенные запятыми. | |
| list логическое |
| Указать, разрешить или запретить просмотр списка файлов в случае, если у пользователя нет разрешения на доступ к общей папке. Также известно как Перечисление на основе доступа. |
| 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 список | success | Список командлетов действий, которые были выполнены модулем. Пример: ['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.9/modules/win_share_module.html
