SmbjClientProviderService - ACAL Lynxus 组件文档

SmbjClientProviderService Controller Service

类型全限定名：cn.org.acal.lynxus.services.smb.SmbjClientProviderService

所属 Bundle：cn.org.acal.lynxus:lynxus-smb-smbj-client-nar:2.11.8

描述

通过共享身份验证凭据提供对 SMB 会话的访问。

标签

samba, smb, cifs, files

属性

下表中，加粗的属性为必填项；其余为可选项。表格同时标注默认值、是否支持表达式语言，以及是否为敏感属性（值会被加密）。

名称	默认值	可选值	描述
Hostname			SMB 文件服务器的网络主机。
Port	`445`		用于连接的端口。
共享			要列出文件的网络共享。这是主机名后的"第一个文件夹"：smb://hostname:port/[share]/dir1/dir2
Username	`Guest`		用于身份验证的用户名。
Password			用于身份验证的密码。敏感属性：是
Domain			用于身份验证的域。可选，在大多数情况下用户名和密码就足够了。
SMB Dialect	`AUTO`	AUTO SMB 2.0.2 SMB 2.1 SMB 3.0 SMB 3.0.2 SMB 3.1.1	SMB 方言默认在客户端和服务器之间协商，选择双方支持的最高公共版本。在某些罕见情况下，使用自动协商的方言可能导致客户端-服务器通信失败。此属性可用于在这些情况下显式设置方言（例如降级到较低版本）。
使用加密	`false`	true false	开启/关闭客户端与服务器之间的加密通信。此属性的行为取决于 SMB 方言：SMB 2.x 不支持加密，此属性无效。对于 SMB 3.x，这是向服务器发出的提示/请求，如果服务器也支持加密则开启加密。
Enable DFS	`false`	true false	允许在 SMB 操作期间访问分布式文件系统 (DFS) 并跟踪 DFS 链接。
Timeout	`5 sec`		读写操作超时。

状态管理

该组件不存储状态。

受限 (Restricted)

该组件不受限。

提供的 Service API

SmbClientProviderService (cn.org.acal.lynxus-lynxus-smb-client-api-nar-2.11.8)