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 логическое значение добавлен в 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 список | успех | Список командлетов действий, которые были выполнены модулем. Пример: ['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.8/modules/win_share_module.html
