使用 FTP 操作组上传和下载文件以及操作 FTP 服务器上的目录。
要建立 FTP 连接，请使用打开 FTP 连接操作。 以下示例具有指定的主机、端口和凭据。 此外，如果未按时建立连接，设置的超时会使操作失败。
使用从 FTP 下载文件操作下载文件。 以下示例显示了正在使用的连接变量和选定的目标文件夹。 还指定了远程文件，并将其设置为覆盖同一位置中的现有文件。
通过使用将文件上传到 FTP 操作并指定文件和远程位置上传文件。
重要提示
从 2.56 版开始， Power Automate 桌面版不再支持安全 FTP（SFTP）操作中废弃的传统密码算法。 此更新旨在通过删除过时的加密方法来增强安全性。
不再支持以下算法：
- blowfish-cbc
- twofish-cbc
- twofish192-cbc
- twofish128-cbc
- 二鱼 256-CBC
- arcfour
- arcfour128
- arcfour256
- cast128-cbc
- hmac-sha2-512-96
- hmac-sha2-256-96
- hmac-sha1-96
- hmac-md5
- hmac-md5-96
- HMAC-SHA1-96-ETM
- hmac-md5-etm
- HMAC-MD5-96-ETM
在 2.56 版 Power Automate 桌面版中执行 SFTP 操作时，完全依赖过时密码算法的 SFTP 服务器的用户可能会遇到传输失败，因为这些服务器与更新的库不兼容。
为确保无缝体验并避免工作流中断，请按照下列步骤作：
- 检查您的 SFTP 服务器支持哪些密码算法。
- 如果您的服务器使用已弃用的密码算法，请更新它以支持现代且安全的密码算法。
- 请咨询您的 IT 团队或 SFTP 服务器提供商，以获取有关升级服务器加密功能的指导。
- 在将 SFTP 服务器迁移到兼容版本之前，请避免安装版本 2.56 或更高版本。
打开 FTP 连接
此操作将与远程 FTP 服务器建立特定连接，并将该连接存储为变量以供日后使用。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| Host | 否 | 文本值 | 在此处输入 FTP 服务器地址。 | |
| Port | 是 | 数值 | 21 | 在此处输入 FTP 服务器端口。 |
| Active mode | 不适用 | 布尔值 | 假 | 指定连接的模式 |
| Username | 否 | 文本值 | 指定要使用的 FTP 帐户的用户名 | |
| 密码 | 是 | 直接加密的输入或文本值 | 指定要使用的 FTP 帐户的密码 | |
| 超时 | 是 | 数值 | 10 | 设置您希望在操作失败之前等待连接建立的时间(以秒为单位) |
生成的变量
| 参数 | 类型 | 说明 |
|---|---|---|
| FTPConnection | FTP 连接 | FTP 连接 |
异常
| 例外 | 描述 |
|---|---|
| 登录失败错误 | 指示登录失败 |
| 连接错误 | 指示连接出现问题 |
列出 FTP 目录
此操作返回 FTP 连接的当前目录中包含的子目录和文件。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| Connection | 否 | FTP 连接 | FTP 连接 | |
| Path | 是 | 文本值 | 要列出的路径。 |
生成的变量
| 参数 | 类型 | 说明 |
|---|---|---|
| Directories | FTP 目录列表 | 列出的目录 |
| 文件 | FTP 文件列表 | 列出的文件 |
异常
| 例外 | 说明 |
|---|---|
| 列表错误 | 指示无法执行文件夹的列表 |
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
| 目录不存在错误 | 指示找不到目录 |
打开安全 FTP 连接
此操作将建立与远程 FTP 服务器的特定安全连接，并将该连接存储为变量以供日后使用。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| Host | 否 | 文本值 | 在此处输入 FTP 服务器地址。 | |
| Port | 是 | 数值 | 22 | 在此处输入 FTP 服务器端口。 |
| Active mode | 不适用 | 布尔值 | 真 | 指定连接的模式 |
| Secure FTP Protocol | 不适用 | SFTP、显式 FTPS、隐式 FTPS | SFTP | 选择希望用于加密连接的 FTP 协议 |
| Authentication method | 不适用 | 用户名和密码、私钥、私钥和密码 | 用户名和密码 | 选择您希望用于在 FTP 服务器上对自己进行身份验证的方法 |
| User name | 否 | 文本值 | 指定要使用的 FTP 帐户的用户名 | |
| 密码 | 是 | 直接加密的输入或文本值 | 指定希望使用的 FTP 帐户的密码 | |
| Path to private key | 否 | 文本值 | 输入用于身份验证的私钥的文件路径 | |
| 私钥密码 | 是 | 直接加密的输入或文本值 | 在此处输入包含私钥密码的变量 | |
| Timeout | 是 | 数值 | 10 | 设置您希望在操作失败之前等待连接建立的时间(以秒为单位) |
生成的变量
| 参数 | 类型 | 说明 |
|---|---|---|
| SftpConnection | FTP 连接 | SFTP 连接 |
异常
| 例外 | 描述 |
|---|---|
| 登录失败错误 | 指示登录失败 |
| 连接错误 | 指示连接出现问题 |
关闭连接
此操作将关闭打开的 FTP 连接。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| Connection | 否 | FTP 连接 | FTP 连接 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
更改工作目录
此操作可设置 FTP 连接的当前工作目录。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| Connection | 否 | FTP 连接 | FTP 连接 | |
| Set working directory to | 否 | 文本值 | 设置要设为工作目录的路径 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
| 目录不存在错误 | 指示找不到目录 |
| 无法更改工作目录错误 | 指示无法更改工作目录 |
从 FTP 下载文件
从 FTP 服务器下载一个或多个文件。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| FTP connection | 否 | FTP 连接 | 要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 | |
| Download into folder | 否 | 文件夹 | 所要下载的文件的目标文件夹 | |
| 要下载的文件 | 否 | FTP 文件列表 | 要下载的文件 | |
| 传输类型 | 不适用 | 自动、二进制、ASCII | 自动 | 输入 ASCII 或二进制数据以指定下载单个文件的方式。 如果不确定文件类型或下载了多个文件，请选择“自动”以遵循选项中指定的传输规则 |
| If file exists | 不适用 | 覆盖、不下载、使用唯一名称下载 | 覆盖 | 指定文件已存在时要执行的操作。 覆盖原始文件上的内容，以便不再访问，“下载时使用唯一名称”并在末尾添加下划线和序列号 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
| 远程文件不存在错误 | 指示 FTP 服务器上不存在文件 |
| 目录不存在错误 | 指示找不到目录 |
| FTP 连接中止错误 | 指示 FTP 连接已中止 |
| 无法下载文件错误 | 指示无法下载文件 |
从 FTP 下载文件夹
从 FTP 服务器下载一个或多个文件夹。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| FTP connection | 否 | FTP 连接 | 要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 | |
| Folder(s) to download | 否 | FTP 目录列表 | 要下载的文件夹路径或 FTP 文件夹名称 | |
| Download into local folder | 否 | 文件夹 | 您下载的 FTP 文件夹的完整目标路径 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
| 远程目录不存在错误 | 指示 FTP 服务器上不存在目录 |
| 目录不存在错误 | 指示找不到目录 |
| FTP 连接中止错误 | 指示 FTP 连接已中止 |
| 无法下载目录错误 | 指示无法下载目录 |
将文件上传到 FTP
将一个或多个文件上传到 FTP 服务器。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| FTP connection | 否 | FTP 连接 | 要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 | |
| File(s) to upload | 否 | 文件列表 | 要上传的文件 | |
| Remote ___location | 是 | 文本值 | 文件应上传到的位置 | |
| Transfer type | 不适用 | 自动、二进制、ASCII | 自动 | 输入 ASCII 或二进制数据以指定下载单个文件的方式。 如果不确定文件类型或下载了多个文件，请选择“自动”以遵循选项中指定的传输规则 |
| If file exists | 不适用 | 覆盖、不下载、使用唯一名称下载 | 覆盖 | 指定文件已存在时要执行的操作。 覆盖原始文件上的内容，以便不再访问，“下载时使用唯一名称”将在末尾添加下划线和序列号 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
| 找不到文件错误 | 指示找不到文件 |
| FTP 连接中止错误 | 指示 FTP 连接已中止 |
| 上传文件错误 | 指示无法上传文件 |
将文件夹上传到 FTP
将一个或多个文件夹上传到 FTP 服务器。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| FTP connection | 否 | FTP 连接 | 要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 | |
| Folder(s) to upload | 否 | 文件夹列表 | 要上载的文件夹。 要上传的文件夹不应已存在于 FTP 服务器的 Active Directory 中 | |
| Remote ___location | 否 | 文本值 | 文件夹应上传到的位置 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
| 远程目录不存在错误 | 指示 FTP 服务器上不存在目录 |
| FTP 连接中止错误 | 指示 FTP 连接已中止 |
| 上传目录错误 | 指示无法上传目录 |
删除 FTP 文件
从 FTP 服务器中删除一个或多个文件。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| FTP connection | 否 | FTP 连接 | 要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 | |
| 要删除的文件 | 否 | FTP 文件列表 | 要删除的文件 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
| 找不到文件错误 | 指示找不到文件 |
| 无法删除文件错误 | 指示无法删除文件 |
重命名 FTP 文件
对位于 FTP 服务器上的文件进行重命名。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| FTP connection | 否 | FTP 连接 | 要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 | |
| 要重命名的文件 | 否 | FTP 文件 | 要重命名的文件 | |
| 新文件名 | 否 | 文本值 | 文件的新名称。 输入包含文件将移动至的路径的名称。 如果该位置不存在，此操作将引发异常 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
| 无法重命名文件错误 | 指示无法重命名文件 |
| 找不到文件错误 | 指示找不到文件 |
创建 FTP 目录
在 FTP 服务器上创建目录。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| FTP connection | 否 | FTP 连接 | 要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 | |
| New directory | 否 | FTP 目录 | 新目录。 如果指定了路径，系统将创建指向此新目录的所有新文件夹 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 拒绝访问错误 | 指示此帐户无权执行某项操作 |
| 文件存在错误 | 指示该文件已存在 |
| 创建目录错误 | 指示无法创建目录 |
| 目录不存在错误 | 指示找不到目录 |
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
删除 FTP 目录
从 FTP 服务器中删除目录。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| FTP connection | 否 | FTP 连接 | 要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 | |
| Directory to delete | 否 | FTP 目录 | 要删除的文件夹。 文件夹中的所有内容也都会删除 |
生成的变量
此操作不会生成任何变量。
异常
| 例外 | 说明 |
|---|---|
| 删除目录错误 | 指示无法删除目录 |
| 远程目录不存在错误 | 指示 FTP 服务器上不存在目录 |
| 工作目录更改错误 | 指示工作目录无法更改 |
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
调用 FTP 命令
在服务器上调用给定的文字 FTP 命令。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| FTP connection | 否 | FTP 连接 | 要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 | |
| FTP command | 否 | 文本值 | 与任何参数一起运行的命令。 例如，您可以在这里运行 FEAT 或 CHMOD | |
| Valid reply code(s) | 是 | 文本值 | 可通过命令返回的代码，使用分号分隔。 如果 FTP 命令返回未在此处输入的代码，此操作将引发异常。 仅适用于简单 FTP 或 FTPS 连接 |
生成的变量
| 参数 | 类型 | 说明 |
|---|---|---|
| ReplyCode | 文本值 | 返回的实际代码。 仅适用于简单 FTP 或 FTPS 连接 |
| ReplyText | 文本值 | FTP 服务器返回的文本 |
异常
| 例外 | 说明 |
|---|---|
| 调用命令错误 | 指示调用 FTP 命令时出错 |
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
同步目录
将给定文件夹的文件和子目录与给定的远程 FTP 目录进行同步。
输入参数
| 参数 | 可选 | 接受 | 默认值 | 说明 |
|---|---|---|---|---|
| FTP connection | 否 | FTP 连接 | 要使用的 FTP 连接。 必须在打开 FTP 连接操作中预先指定此变量 | |
| Synchronization direction | 不可用 | 远程 -> 本地(下载)、本地 -> 远程(上载) | 远程 -> 本地(下载) | 同步方法的方向。 本地文件夹是否将同步到远程目录（下载），或远程目录是否将同步到本地文件夹（上载） |
| Files to sync | 不适用 | 所有文件、仅限与文件筛选器匹配的文件、仅限与文件筛选器不匹配的文件 | 所有文件 | 选择是要同步所有文件，还是使用文件筛选器来包含或排除特定的文件集 |
| 文件夹筛选器 | 否 | 文本值 | * | 用于控制包含或排除哪些文件的文件名称模式。 此选项允许使用通配符，如“.txt”或“document?.doc”。此选项还允许多个筛选器，并使用逗号作为分隔符，例如，“.txt,*.pdf,document?” |
| Local folder | 否 | 文件夹 | 要同步的本地文件夹的名称 | |
| FTP directory | 是 | FTP 目录 | / | 要同步的 FTP 目录的名称 |
| Delete if source is absent | 不适用 | 布尔值 | 错误 | 此选项将删除目标目录而非源目录中存在的文件或文件夹。 |
| Include subdirectories | 不适用 | 布尔值 | 真 | 此选项将在同步过程中包含子目录。 |
| Time difference in hours | 是 | 数值 | 0 | 远程服务器在不同时区运行时的时差(以小时为单位)。 |
| Time difference in minutes | 是 | 数值 | 0 | 远程服务器在不同时区运行时的时差(以分钟为单位)。 |
| Time difference ahead | 不适用 | 布尔值 | 真 | 指定服务器的时区是否提前。 |
生成的变量
| 参数 | 类型 | 说明 |
|---|---|---|
| FtpFilesAdded | FTP 文件列表 | 最初存在于源中，但在同步过程之后添加到目标的 FTP 文件列表。 |
| FtpFilesModified | FTP 文件列表 | 最初存在于源中和目标中，但在同步过程之后添加到目标的 FTP 文件列表。 |
| FtpFilesDeleted | FTP 文件列表 | 最初存在于目标目录中，但在同步过程之后删除的 FTP 文件列表。 |
| FilesAdded | 文件列表 | 最初存在于源中，但在同步过程之后添加到目标的文件列表。 |
| FilesModified | 文件列表 | 最初存在于源中和目标中，但在同步过程之后添加到目标的文件列表。 |
| FilesDeleted | 文件列表 | 最初存在于目标目录中，但在同步过程之后删除的文件列表。 |
异常
| 例外 | 说明 |
|---|---|
| 列表错误 | 指示无法执行文件夹的列表 |
| 未连接错误 | 指示 FTP 服务器没有打开的连接 |
| 找不到文件错误 | 指示找不到文件 |
| FTP 连接中止错误 | 指示 FTP 连接已中止 |
| 上传文件错误 | 指示无法上传文件 |
| 远程文件不存在错误 | 指示 FTP 服务器上不存在文件 |
| 无法下载文件错误 | 指示无法下载文件 |
| 删除目录错误 | 指示无法删除目录 |
| 同步失败错误 | 指示由于发生意外错误导致同步过程失败。 |