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)
|
нет | Manual |
|
Устанавливает режим кэширования для этой общей папки. |
| change |
нет | Указывает список пользователей, которым необходимо предоставить чтение и запись в общую папку, разделенные запятыми. | ||
| deny |
нет | Указывает список пользователей, которым необходимо запретить доступ, независимо от предполагаемого доступа к общей папке, разделенные запятыми. | ||
| description |
нет | Описание общей папки. | ||
| encrypt (Добавлен в 2.4)
|
нет | нет |
|
Устанавливает, следует ли шифровать трафик в общую папку. |
| full |
нет | Указывает список пользователей, которым необходимо предоставить полный доступ к общей папке, разделенные запятыми. | ||
| list |
нет | нет |
|
Указывает, следует ли разрешить или запретить просмотр списка файлов в случае, если у пользователя нет разрешения на доступ к общей папке. |
| name |
да | Имя общей папки. | ||
| path |
да | Директория общей папки. | ||
| read |
нет | Указывает список пользователей, которым необходимо предоставить доступ для чтения к общей папке, разделенные запятыми. | ||
| state |
нет | present |
|
Указывает, следует ли добавить 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'] |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Информация о поддержке
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этом knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
Для получения помощи в разработке модулей, если вы захотите, ознакомьтесь с Информацией о сообществе и участии в разработке, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_share_module.html
