ansible.windows.win_share – Manage Windows shares — Ansible 2.11

Примечание

Этот плагин входит в состав коллекции 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	Установить режим кэширования для этой общей папки.
change строка		Укажите список пользователей, которым следует предоставить доступ для чтения и записи в общую папку, разделенные запятыми.
deny строка		Укажите список пользователей, которым не следует предоставлять доступ, независимо от предполагаемого доступа к общей папке, разделенные запятыми.
description строка		Описание общей папки.
encrypt логический	Варианты: нет ← да	Установить, следует ли шифровать трафик в общую папку.
full строка		Укажите список пользователей, которым следует предоставить полный доступ к общей папке, разделенные запятыми.
list логический	Варианты: нет ← да	Указать, разрешено или запрещено перечисление файлов в случае, если у пользователя нет разрешений на общую папку. Также известно как перечисление на основе доступа.
name строка / обязательно		Имя общей папки.
path путь / обязательно		Директория общей папки.
read строка		Укажите список пользователей, которым следует предоставить доступ для чтения в общую папку, разделенные запятыми.
rule_action строка	Варианты: установить ← добавить	Следует ли добавить или установить (заменить) записи управления доступом.
state строка	Варианты: absent present ←	Укажите, следует ли добавить `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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/windows/win_share_module.html