community.general.udm_share 模块 – 在 Univention 企业服务器上管理 samba 共享

注意

此模块是 community.general 集合（版本 10.1.0）的一部分。

如果您使用的是 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.udm_share。

概要

  • 此模块允许在 Univention 企业服务器 (UCS) 上管理 samba 共享。它使用 UCS 的 Python API 创建新对象或编辑它。

参数

参数

注释

directorymode

字符串

共享根目录的权限。

默认值： "00755"

group

字符串

共享根目录的目录所有者组。

默认值： "0"

host

字符串

主机 FQDN（提供共享的服务器），例如 {{ ansible_fqdn }}。如果 state=present，则为必需。

name

字符串 / 必需

名称

nfs_hosts

列表 / 元素=字符串

仅允许此主机、IP 地址或网络访问。

默认值： []

nfsCustomSettings

别名：nfs_custom_settings

列表 / 元素=字符串

exports 文件中的选项名称。

默认值： []

ou

字符串 / 必需

组织单位，在 LDAP Base DN 内。

owner

字符串

共享根目录的目录所有者。

默认值： "0"

path

path

提供服务器上的目录，例如 /home。如果 state=present，则为必需。

root_squash

布尔值

修改 root 用户的用户 ID（root squash）。

选择

  • false

  • true ←（默认值）

sambaBlockingLocks

别名：samba_blocking_locks

布尔值

阻止锁。

选择

  • false

  • true ←（默认值）

sambaBlockSize

别名：samba_block_size

字符串

块大小。

sambaBrowseable

别名：samba_browsable

布尔值

在 Windows 网络环境中显示。

选择

  • false

  • true ←（默认值）

sambaCreateMode

别名：samba_create_mode

字符串

文件模式。

默认值： "0744"

sambaCscPolicy

别名：samba_csc_policy

字符串

客户端缓存策略。

默认值： "manual"

sambaCustomSettings

别名：samba_custom_settings

列表 / 元素=字典

smb.conf 中的选项名称及其值。

默认值： []

sambaDirectoryMode

别名：samba_directory_mode

字符串

目录模式。

默认值： "0755"

sambaDirectorySecurityMode

别名：samba_directory_security_mode

字符串

目录安全模式。

默认值： "0777"

sambaDosFilemode

别名：samba_dos_filemode

布尔值

具有写入访问权限的用户可以修改权限。

选择

  • false ←（默认值）

  • true

sambaFakeOplocks

别名：samba_fake_oplocks

布尔值

伪造 oplock。

选择

  • false ←（默认值）

  • true

sambaForceCreateMode

别名：samba_force_create_mode

布尔值

强制文件模式。

选择

  • false ←（默认值）

  • true

sambaForceDirectoryMode

别名：samba_force_directory_mode

布尔值

强制目录模式。

选择

  • false ←（默认值）

  • true

sambaForceDirectorySecurityMode

别名：samba_force_directory_security_mode

布尔值

强制目录安全模式。

选择

  • false ←（默认值）

  • true

sambaForceGroup

别名: samba_force_group

字符串

强制组。

sambaForceSecurityMode

别名: samba_force_security_mode

布尔值

强制安全模式。

选择

  • false ←（默认值）

  • true

sambaForceUser

别名: samba_force_user

字符串

强制用户。

sambaHideFiles

别名: samba_hide_files

字符串

隐藏文件。

sambaHideUnreadable

别名: samba_hide_unreadable

布尔值

隐藏不可读的文件/目录。

选择

  • false ←（默认值）

  • true

sambaHostsAllow

别名: samba_hosts_allow

列表 / 元素=字符串

允许的主机/网络。

默认值： []

sambaHostsDeny

别名: samba_hosts_deny

列表 / 元素=字符串

拒绝的主机/网络。

默认值： []

sambaInheritAcls

别名: samba_inherit_acls

布尔值

继承 ACL。

选择

  • false

  • true ←（默认值）

sambaInheritOwner

别名: samba_inherit_owner

布尔值

使用父目录的所有者创建文件/目录。

选择

  • false ←（默认值）

  • true

sambaInheritPermissions

别名: samba_inherit_permissions

布尔值

使用父目录的权限创建文件/目录。

选择

  • false ←（默认值）

  • true

sambaInvalidUsers

别名: samba_invalid_users

字符串

无效的用户或组。

sambaLevel2Oplocks

别名: samba_level_2_oplocks

布尔值

二级机会锁。

选择

  • false

  • true ←（默认值）

sambaLocking

别名: samba_locking

布尔值

锁定。

选择

  • false

  • true ←（默认值）

sambaMSDFSRoot

别名: samba_msdfs_root

布尔值

MSDFS 根目录。

选择

  • false ←（默认值）

  • true

sambaName

别名: samba_name

字符串

Windows 名称。如果 state=present，则为必需项。

sambaNtAclSupport

别名: samba_nt_acl_support

布尔值

NT ACL 支持。

选择

  • false

  • true ←（默认值）

sambaOplocks

别名: samba_oplocks

布尔值

机会锁。

选择

  • false

  • true ←（默认值）

sambaPostexec

别名: samba_postexec

字符串

执行后脚本。

sambaPreexec

别名: samba_preexec

字符串

执行前脚本。

sambaPublic

别名: samba_public

布尔值

允许使用访客用户的匿名只读访问。

选择

  • false ←（默认值）

  • true

sambaSecurityMode

别名: samba_security_mode

字符串

安全模式。

默认值： "0777"

sambaStrictLocking

别名: samba_strict_locking

字符串

严格锁定。

默认值: "Auto"

sambaValidUsers

别名: samba_valid_users

字符串

有效的用户或组。

sambaVFSObjects

别名: samba_vfs_objects

字符串

VFS 对象。

sambaWriteable

别名: samba_writeable

布尔值

Samba 写访问。

选择

  • false

  • true ←（默认值）

sambaWriteList

别名: samba_write_list

字符串

限制对这些用户/组的写访问。

state

字符串

共享是否存在。

选择

  • "present" ← (默认)

  • "absent"

subtree_checking

布尔值

子树检查。

选择

  • false

  • true ←（默认值）

sync

字符串

NFS 同步。

默认值: "sync"

writeable

布尔值

NFS 写访问。

选择

  • false

  • true ←（默认值）

属性

属性

支持

描述

check_mode

支持: 完整

可以在 check_mode 模式下运行，并返回更改状态预测，而无需修改目标。

diff_mode

支持: 部分

当处于 diff 模式时，将返回已更改内容（或在 check_mode 中可能需要更改的内容）的详细信息。

示例

- name: Create a share named home on the server ucs.example.com with the path /home
  community.general.udm_share:
    name: home
    path: /home
    host: ucs.example.com
    sambaName: Home

作者

  • Tobias Rüetschi (@keachi)