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 (добавлено в 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'] |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний.
Автор
- Ханс-Йоахим Климек (@h0nIg)
- Дэвид Баумгартнер (@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.5/modules/win_share_module.html
