win_share – Manage Windows shares — Ansible 2.10

Примечание

Этот плагин входит в состав коллекции ansible.windows (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install ansible.windows.

Для использования в плейбуке укажите: ansible.windows.win_share.

Обзор
Требования
Параметры
Примеры
Возвращаемые значения

Обзор

Добавление, изменение или удаление общих папок Windows и установка прав доступа к ним.

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

Так как этот модуль использует новые командлеты, такие как New-SmbShare, он может работать только на Windows 8 / Windows 2012 или более поздних версиях.
Это связано с зависимостью от поставщика WMI MSFT_SmbShare https://msdn.microsoft.com/en-us/library/hh830471, который был добавлен только в этих версиях Windows.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
caching_mode строка	Варианты: BranchCache Documents Manual ← None Programs Unknown	Установить CachingMode для этой общей папки.
change строка		Укажите список пользователей, которым следует предоставить чтение и запись в общей папке, разделенные запятыми.
deny строка		Укажите список пользователей, которым не следует предоставлять доступ, независимо от предполагаемого доступа к общей папке, разделенные запятыми.
description строка		Описание общей папки.
encrypt логическое значение	Варианты: нет ← да	Устанавливает, следует ли шифровать трафик в общую папку.
full строка		Укажите список пользователей, которым следует предоставить полный доступ к общей папке, разделенные запятыми.
list логическое значение	Варианты: нет ← да	Укажите, разрешить или запретить просмотр файлов в случае, если у пользователя нет прав доступа к общей папке. Также известен как перечисление на основе доступа.
name строка / обязательно		Имя общей папки.
path путь / обязательно		Директория общей папки.
read строка		Укажите список пользователей, которым следует предоставить чтение в общей папке, разделенные запятыми.
rule_action строка	Варианты: установить ← добавить	Добавить или установить (заменить) записи управления доступом.
state строка	Варианты: отсутствует есть ←	Укажите, добавить `present` или удалить `absent` указанную общую папку.

Примеры

- name: Add secret share
  ansible.windows.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
  ansible.windows.win_share:
    name: company
    description: top secret share
    path: C:\shares\company
    list: yes
    full: Administrators,CEO
    read: Global

- name: Remove previously added share
  ansible.windows.win_share:
    name: internal
    state: absent

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
actions список / элементы=строка	успех	Список командлетов действий, которые были выполнены модулем. Пример: ['New-SmbShare -Name share -Path C:\\temp']

Авторы

Hans-Joachim Kliemeck (@h0nIg)
David Baumann (@daBONDi)
Shachaf Goldstein (@Shachaf92)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/windows/win_share_module.html