win_share – Manage Windows shares

From Get docs
Ansible/docs/2.7/modules/win share module


win_share – Manage Windows shares

New in version 2.1.


Synopsis

  • Add, modify or remove Windows share and set share permissions.

Requirements

The below requirements are needed on the host that executes this module.

  • As this module used newer cmdlets like New-SmbShare this can only run on Windows 8 / Windows 2012 or newer.
  • This is due to the reliance on the WMI provider MSFT_SmbShare https://msdn.microsoft.com/en-us/library/hh830471 which was only added with these Windows releases.

Parameters

Parameter Choices/Defaults Comments

caching_mode

-

added in 2.3

  • BranchCache
  • Documents
  • Manual

  • None
  • Programs
  • Unknown

Set the CachingMode for this share.

change

-

Specify user list that should get read and write access on share, separated by comma.

deny

-

Specify user list that should get no access, regardless of implied access on share, separated by comma.

description

-

Share description.

encrypt

boolean

added in 2.4

  • no

  • yes

Sets whether to encrypt the traffic to the share or not.

full

-

Specify user list that should get full access on share, separated by comma.

list

boolean

  • no

  • yes

Specify whether to allow or deny file listing, in case user has no permission on share. Also known as Access-Based Enumeration.

name

- / required

Share name.

path

path / required

Share directory.

read

-

Specify user list that should get read access on share, separated by comma.

state

-

  • absent
  • present

Specify whether to add present or remove absent the specified share.



Examples

# 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

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description

actions

list

success

A list of action cmdlets that were run by the module.


Sample:

['New-SmbShare -Name share -Path C:\\temp']




Status

Red Hat Support

More information about Red Hat’s support of this module is available from this Red Hat Knowledge Base article.

Authors

  • Hans-Joachim Kliemeck (@h0nIg)
  • David Baumann (@daBONDi)

Hint

If you notice any issues in this documentation you can edit this document to improve it.


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