FTP

使用 FTP 動作群組上傳和下載檔案，並在 FTP 伺服器上操縱目錄。

若要建立 FTP 連線，請使用開啟 FTP 連線動作。 下列範例具有指定的主機、連接埠及認證。 此外，如果無法按時建立連接，則設定逾時會讓動作失敗。

使用從 FTP 下載檔案動作下載檔案。 以下範例顯示使用中的連線變數，和選定的目標資料夾。 已指定遠端檔案，並將其設定為覆寫相同位置中的現有檔案。

使用將檔案上傳至 FTP 動作和指定檔案和遠端位置，來上傳檔案。

重要

從 2.56 版開始，桌面版 Power Automate 不再支援安全 FTP (SFTP) 動作中已取代的舊式密碼演算法。 此更新旨在透過刪除過時的加密方法來增強安全性。

以下演算法不再受支援：

• blowfish-cbc
• twofish-cbc
• twofish192-cbc
• twofish128-cbc
• twofish256-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

如果使用者在桌面版 Power Automate 2.56 版中執行 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 連線。

輸入參數

引數	選用	接受	預設值	描述
連線	否	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 伺服器的使用中目錄不應該出現即將上傳的資料夾
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 伺服器中
無法下載檔案錯誤	指示無法下載檔案
刪除目錄錯誤	指示無法刪除目錄
同步處理失敗錯誤	指示同步處理因發生意外錯誤而失敗。