ansible / ansible.builtin / v2.4.2.0-1 / module / udm_share Manage samba shares on a univention corporate server | "added in version" 2.2 of ansible.builtin" Authors: Tobias Rueetschi (@2-B) preview | supported by communityansible.builtin.udm_share (v2.4.2.0-1) — module
pip
Install with pip install ansible==2.4.2.0.post1
This module allows to manage samba shares on a univention corporate server (UCS). It uses the python API of the UCS to create a new object or edit it.
# Create a share named home on the server ucs.example.com with the path /home. - udm_share: name: home path: /home host: ucs.example.com sambaName: Home
ou: description: - Organisational unit, inside the LDAP Base DN. required: true host: default: None description: - Host FQDN (server which provides the share), e.g. C({{ ansible_fqdn }}). Required if C(state=present). required: false name: description: - Name required: true path: default: None description: - Directory on the providing server, e.g. C(/home). Required if C(state=present). required: false sync: default: sync description: - NFS synchronisation. required: false group: default: '0' description: - Directory owner group of the share's root directory. required: false owner: default: 0 description: - Directory owner of the share's root directory. required: false state: choices: - present - absent default: present description: - Whether the share is present or not. required: false nfs_hosts: default: [] description: - Only allow access for this host, IP address or network. required: false writeable: choices: - '0' - '1' default: '1' description: - NFS write access. required: false samba_name: aliases: - sambaName default: None description: - Windows name. Required if C(state=present). required: false root_squash: choices: - '0' - '1' default: '1' description: - Modify user ID for root user (root squashing). required: false samba_public: aliases: - sambaPublic choices: - '0' - '1' default: '0' description: - Allow anonymous read-only access with a guest user. required: false directorymode: default: '00755' description: - Permissions for the share's root directory. required: false samba_locking: aliases: - sambaLocking choices: - '0' - '1' default: '1' description: - Locking. required: false samba_oplocks: aliases: - sambaOplocks choices: - '0' - '1' default: '1' description: - Oplocks. required: false samba_preexec: aliases: - sambaPreexec default: None description: - Preexec script. required: false samba_postexec: aliases: - sambaPostexec default: None description: - Postexec script. required: false samba_writeable: aliases: - sambaWriteable choices: - '0' - '1' default: '1' description: - Samba write access. required: false samba_block_size: aliases: - sambaBlockSize default: None description: - Blocking size. required: false samba_browseable: aliases: - sambaBrowseable choices: - '0' - '1' default: '1' description: - Show in Windows network environment. required: false samba_csc_policy: aliases: - sambaCscPolicy default: manual description: - Client-side caching policy. required: false samba_force_user: aliases: - sambaForceUser default: None description: - Force user. required: false samba_hide_files: aliases: - sambaHideFiles default: None description: - Hide files. required: false samba_hosts_deny: aliases: - sambaHostsDeny default: [] description: - Denied host/network. required: false samba_msdfs_root: aliases: - sambaMSDFSRoot choices: - '0' - '1' default: '0' description: - MSDFS root. required: false samba_write_list: aliases: - sambaWriteList default: None description: - Restrict write access to these users/groups. required: false subtree_checking: choices: - '0' - '1' default: '1' description: - Subtree checking. required: false samba_create_mode: aliases: - sambaCreateMode default: '0744' description: - File mode. required: false samba_force_group: aliases: - sambaForceGroup default: None description: - Force group. required: false samba_hosts_allow: aliases: - sambaHostsAllow default: [] description: - Allowed host/network. required: false samba_valid_users: aliases: - sambaValidUsers default: None description: - Valid users or groups. required: false samba_vfs_objects: aliases: - sambaVFSObjects default: None description: - VFS objects. required: false samba_dos_filemode: aliases: - sambaDosFilemode choices: - '0' - '1' default: '0' description: - Users with write access may modify permissions. required: false samba_fake_oplocks: aliases: - sambaFakeOplocks choices: - '0' - '1' default: '0' description: - Fake oplocks. required: false samba_inherit_acls: aliases: - sambaInheritAcls choices: - '0' - '1' default: '1' description: - Inherit ACLs. required: false nfs_custom_settings: aliases: - nfsCustomSettings default: [] description: - Option name in exports file. required: false samba_inherit_owner: aliases: - sambaInheritOwner choices: - '0' - '1' default: '0' description: - Create files/directories with the owner of the parent directory. required: false samba_invalid_users: aliases: - sambaInvalidUsers default: None description: - Invalid users or groups. required: false samba_security_mode: aliases: - sambaSecurityMode default: '0777' description: - Security mode. required: false samba_blocking_locks: aliases: - sambaBlockingLocks choices: - '0' - '1' default: '1' description: - Blocking locks. required: false samba_directory_mode: aliases: - sambaDirectoryMode default: '0755' description: - Directory mode. required: false samba_nt_acl_support: aliases: - sambaNtAclSupport choices: - '0' - '1' default: '1' description: - NT ACL support. required: false samba_strict_locking: aliases: - sambaStrictLocking default: Auto description: - Strict locking. required: false samba_custom_settings: aliases: - sambaCustomSettings default: [] description: - Option name in smb.conf and its value. required: false samba_hide_unreadable: aliases: - sambaHideUnreadable choices: - '0' - '1' default: '0' description: - Hide unreadable files/directories. required: false samba_level_2_oplocks: aliases: - sambaLevel2Oplocks choices: - '0' - '1' default: '1' description: - Level 2 oplocks. required: false samba_force_create_mode: aliases: - sambaForceCreateMode choices: - '0' - '1' default: '0' description: - Force file mode. required: false samba_force_security_mode: aliases: - sambaForceSecurityMode choices: - '0' - '1' default: '0' description: - Force security mode. required: false samba_inherit_permissions: aliases: - sambaInheritPermissions choices: - '0' - '1' default: '0' description: - Create files/directories with permissions of the parent directory. required: false samba_force_directory_mode: aliases: - sambaForceDirectoryMode choices: - '0' - '1' default: '0' description: - Force directory mode. required: false samba_directory_security_mode: aliases: - sambaDirectorySecurityMode default: '0777' description: - Directory security mode. required: false samba_force_directory_security_mode: aliases: - sambaForceDirectorySecurityMode choices: - '0' - '1' default: '0' description: - Force directory security mode. required: false