檔案動作

重要

若要防止未經授權的存取，Windows 要求系統管理員權限來存取受保護的檔案。 若要使用檔案動作來存取這些資源，請以管理員權限執行 Power Automate。 若想知道更多有關以管理員身分執行 Power Automate 的資訊，請移至使用提升的權限執行 Power Automate 。

處理檔案及其內容對大部分自動化案例而言至關重要。 您可以使用檔案動作來管理檔案、擷取其屬性、讀取和寫入資料的桌面流程，以及將這些流程轉換成其他類型。

大部分檔案動作都需要可指定您所要操縱之檔案的路徑。 這些路徑可以是硬編碼值或檔案資料類型變數。

注意

若要提供許多檔案做為輸入，請使用包含檔案項目的清單變數。 用於建立檔案清單的方法是取得資料夾中的檔案動作。

同樣地，您可以填入硬編碼值或資料夾資料類型變數，以在需要目的地資料夾的動作中指定一個。

有些檔案動作會提供廣泛的設定，讓您可以自動化幾乎任何案例。 例如，重新命名檔案動作包括可設定新名稱，或者是新增、取代或移除文字字串到現有檔案名稱的選項。

若要附加文字內容或覆寫文字檔，請部署將文字寫入檔案動作。 若要讀取文字檔的內容，請使用從檔案讀取文字動作。

同樣的，如果您需要讀取或寫入 CSV 檔案的內容，請使用從 CSV 檔案讀取和寫入 CSV 檔案動作。 您可以在將 CSV 檔案轉換為 Excel 試算表中尋找處理 CSV 檔案的範例桌面流程。

如果您想要檢查特定資料夾中是否有檔案，請使用如果檔案存在動作。 此動作是條件動作，可讓您根據檔案是否存在，執行不同的程式碼區域。 若要尋找有關條件的更多資訊，請移至使用條件。

如果檔案存在

根據檔案是否存在，標記條件式動作區塊的開頭。

輸入參數

引數	選用	接受	預設值	描述
If file	無法使用	存在、不存在	存在	要檢查檔案的狀態
檔案路徑	否	檔案		可尋找檔案的完整路徑

變數已產生

此動作不會產生任何變數。

例外狀況

此動作不包括任何例外狀況。

等待檔案

暫停執行自動化處理，直到檔案建立或刪除為止。

輸入參數

引數	選用	接受	預設值	描述
Wait for file to be	無法使用	已建立、已刪除	建立時間	指定是否要在特定檔案進行建立或移除時暫停流程
檔案路徑	否	檔案		可尋找檔案的完整路徑

變數已產生

此動作不會產生任何變數。

例外狀況

此動作不包括任何例外狀況。

複製檔案

將一或多個檔案複製至目的地資料夾。

輸入參數

引數	選用	接受	預設值	名描述
File(s) to copy	否	檔案的清單		要複製的檔案。 此值可以是檔案路徑，或是包含檔案、檔案清單、文字路徑的變數，或文字路徑的清單。 使用「取得資料夾中的檔案」動作，將檔案清單填入變數中。
目的地資料夾	否	資料夾		已複製檔案的目的地資料夾
If file exists	無法使用	不執行任何動作、覆寫	不執行任何動作	指定當目的地資料夾中已存在相同名稱的檔案時應採取的行動

變數已產生

引數	類型​	描述
CopiedFiles	檔案的清單	以檔案清單複製的檔案

例外狀況

例外	描述
來源資料夾不存在	指示來源資料夾不存在
目的地資料夾不存在	指示目的地資料夾不存在
找不到檔案	指示檔案不存在
無法複製檔案	指示複製檔案時發生問題

移動檔案

將一或多個檔案移動至目的地資料夾。

輸入參數

引數	選用	接受	預設值	名描述
File(s) to move	否	檔案的清單		要移動的檔案。 此值可以是檔案路徑，或是包含檔案、檔案清單、文字路徑的變數，或文字路徑的清單。 使用「取得資料夾中的檔案」動作，將檔案清單填入變數中。
目的地資料夾	否	資料夾		已移動檔案的目的地資料夾
If file exists	無法使用	不執行任何動作、覆寫	不執行任何動作	指定當目的地資料夾中已存在相同名稱的檔案時應採取的行動

變數已產生

引數	類型​	描述
MovedFiles	檔案的清單	以檔案清單移動的檔案

例外狀況

例外	描述
來源資料夾不存在	指示來源資料夾不存在
目的地資料夾不存在	指示目的地資料夾不存在
找不到檔案	指示檔案不存在
無法移動檔案	指示移動檔案時發生問題

刪除檔案

刪除一或多個檔案。

輸入參數

引數	選用	接受	預設值	描述
File(s) to delete	否	檔案的清單		要刪除的檔案。 此值可以是檔案路徑，或是包含檔案、檔案清單、文字路徑的變數，或文字路徑的清單。 使用 [取得資料夾中檔案]，將檔案清單填入變數中

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	描述
檔案路徑不存在	指示檔案路徑不存在
找不到檔案	指示檔案不存在
無法刪除檔案	指示刪除檔案時發生問題

重新命名檔案

變更一或多個檔案的名稱。

輸入參數

引數	選用	接受	預設值	名描述
要重新命名的檔案	否	檔案的清單		要重新命名的檔案。 此值可以是檔案路徑，或是包含檔案、檔案清單、文字路徑的變數，或文字路徑的清單。 使用「取得資料夾中的檔案」動作，將檔案清單填入變數中。
Add number to	無法使用	布林值	確判為真	指定是否將數字加入現有檔名或新檔名
Rename scheme	無法使用	設定新名稱、新增文字、移除文字、取代文字、變更副檔名、新增日期時間、建立循序檔	設定新名稱	指定如何重新命名檔案
New file name	否	文字值		檔案的新名稱
New extension	是	文字值		要加入成為檔案之新副檔名的文字
New file name	否	文字值		檔案的新名稱
Add number to	無法使用	名稱之後、名稱之前	名稱之後	指定數字要加在原始名稱或新基底檔案之前或之後
Text to add	是	文字值		要加入至原始檔名的文字
Text to remove	是	文字值		要從原始檔名移除的文字。 這個重新命名結構會搜尋每個檔名，並在每次所輸入文字出現在名稱中時，將其移除。
Text to replace	否	文字值		要在原始檔名中取代的文字。 這個重新命名配置會搜尋每個檔名，並取代任何在名稱中出現所輸入文字的部分
Use custom datetime	無法使用	布林值	否	指定是否使用自訂日期時間
Datetime to add	無法使用	目前日期時間、建立時間、上次存取時間、上次修改時間	目前日期時間	指定要在檔名中加入哪個日期時間值
Keep extension	無法使用	布林值	是	指定是否要在檔名中包含先前的副檔名。 停用這個選項，以手動加入檔案副檔名。
Replace with	是	文字值		要用來取代原始文字的文字
Start numbering at	否	數值		起始編號值
Add text	無法使用	名稱之後、名稱之前	名稱之後	指定文字要加在原始名稱之前或之後
Custom datetime	否	日期時間		要加入至檔名的日期時間
Increment by	否	數值		從起始值起依次遞增的數字
Add datetime	無法使用	名稱之後、名稱之前	名稱之後	指定日期時間要加在原始名稱之前或之後
Separator	無法使用	無、空格、破折號、句號、底線	空格	指定要用來分隔原始檔名與所加入數字的方法，包括不使用分隔符號的選項
Separator	無法使用	無、空格、破折號、句號、底線	空格	指定要用來分隔原始檔名與所加入日期時間值的方法，包括不使用分隔符號的選項
Use padding	無法使用	布林值	False	指定是否要使用填補
日期時間格式	否	文字值	yyyyMMdd	要加入至檔名的日期時間值格式，例如代表日期的 MM/dd/yyyy ，以及代表時間的 hh:mm:sstt
Make each number at least	是	數值	3	每個加入數字的最小長度
If file exists	無法使用	不執行任何動作、覆寫	不執行任何動作	指定當資料夾中已存在相同名稱的檔案時應採取的行動

變數已產生

引數	類型​	描述
RenamedFiles	檔案的清單	以檔案清單重新命名的檔案

例外狀況

例外	描述
找不到目錄	指示未找到目錄
找不到檔案	指示檔案不存在
無法重新命名檔案	指示重新命名檔案時發生問題

從檔案讀取文字

讀取文字檔案的內容。

輸入參數

引數	選用	接受	預設值	描述
File path	否	檔案		要讀取的檔案
Store content as	無法使用	單一文字值、清單 (每個均為清單項目)	單一文字值	指定文字的儲存方式。 選擇 [單一文字值] 以將整個文字儲存為單一文字值。 選擇「清單」以將原始文字的每一行儲存為清單中的文字項目。
編碼	無法使用	系統預設、ASCII、Unicode、Unicode (big-endian)、UTF-8	UTF-8	從文字檔中讀取指定文字的編碼。

變數已產生

引數	類型​	描述
FileContents	文字值	做為文字的內容
FileContents	文字值的清單	做為文字清單的內容

例外狀況

例外	描述
找不到目錄	指示未找到目錄
找不到檔案	指示檔案不存在
無法從檔案讀取	指示從檔案讀取時發生問題

將文字寫入檔案

寫入或附加文字至檔案。

輸入參數

引數	選用	接受	預設值	名描述
檔案路徑	否	檔案		要寫入文字的檔案。 此值可以是檔案路徑，或是包含檔案或文字路徑的變數。
Text to write	是	一般值		要寫入指定檔案的文字
Append new line	無法使用	布林值	是	指定是否在整體文字結尾附加新行，以便寫入檔案
If file exists	無法使用	覆寫現有內容、附加內容	覆寫現有內容	指定是否覆寫現有內容，或附加至現有內容的結尾。 如果檔案不存在，這個動作會自動建立此檔案。
編碼	無法使用	系統預設、ASCII、Unicode、Unicode (big-endian)、UTF-8、Unicode (無位元組順序遮罩)、UTF-8 (無位元組順序遮罩)	Unicode	要寫入文字檔案之指定文字所使用的編碼

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	描述
無法將文字寫入檔案	指示寫入檔案時發生問題
無效的檔案目錄	指示目錄無效

從 CSV 檔案讀取

讀取 CSV 檔案至資料表。

您可以使用從 CSV 檔案讀取動作來建立包含檔案內容的資料表變數。 您需要定義 CSV 檔案的路徑以及用於讀取它的編碼，同時您也可以修剪所提取儲存格中的任何空格，將第一行設定為欄標題，並指定欄分隔符號。

輸入參數

引數	選用	接受	預設值	名描述
檔案路徑	否	檔案		要讀取的 CSV 檔案。 此值可以是檔案路徑，或是包含檔案或文字路徑的變數
Encoding	無法使用	UTF-8、Unicode、Unicode (big-endian)、UTF-8 (無位元組順序標記)、Unicode (無位元組順序標記)、系統預設、ASCII	UTF-8	用來讀取指定 CSV 檔案的編碼
Trim fields	無法使用	布林值	是	指定是否自動修剪所擷取儲存格的前置空格與結尾空白
First line contains column names	無法使用	布林值	否	指定是否要使用 CSV 資源的第一列來設定結果資料表變數的欄名稱。 啟用此選項，可避免將名稱當做資料讀入資料表中。 後續動作可以使用欄名稱 (而不是欄號碼) 來存取資料表所保存的資料。
Columns separator	無法使用	預先定義、自訂、固定欄寬	預先定義	指定是否使用預先定義的欄分隔符號、自訂的欄寬或固定欄寬
Separator	無法使用	系統預設、逗號、分號、定位字元	系統預設	用於剖析 CSV 檔案的欄分隔符號
Custom separator	否	文字值		用來剖析所指定 CSV 資源的自訂欄分隔符號
Fixed column widths	否	文字值		用於剖析所指定 CSV 資源的固定欄寬。 使用逗號、空格、定位字元或分行符號來分隔寬度。

變數已產生

引數	類型​	描述
CSVTable	資料表	做為資料表的 CSV 檔案內容

例外狀況

例外	描述
從 CSV 讀取失敗	指示從 CSV 檔案讀取時發生問題

寫入 CSV 檔案

將資料表、資料列或清單寫入 CSV 檔案。

使用寫入 CSV 檔案動作，將資料表、資料列或清單變數寫入目標 CSV 檔。 在檔案路徑參數中，指定包含資料匯出到的檔案或文字路徑的檔案路徑或變數。

輸入參數

引數	選用	接受	預設值	描述
Variable to write	否	一般值		要寫入目標 CSV 檔案的資料表、資料列變數或清單變數
檔案路徑	否	檔案		要將變數匯出至其中的 CSV 檔案。 此值可以是檔案路徑，或是包含檔案或文字路徑的變數。
編碼	無法使用	UTF-8、Unicode、Unicode (big-endian)、UTF-8 (無位元組順序標記)、Unicode (無位元組順序標記)、系統預設、ASCII	UTF-8	寫入所指定 CSV 檔案時所使用的編碼
Include column names	無法使用	布林值	否	指定所指定變數的欄名稱是否要設為 CSV 檔案的第一列。 只有當目標 CSV 檔案一開始並不存在，或是存在但文字為空白時，此選項才會生效。
如果檔案存在	無法使用	覆寫現有內容、附加內容	覆寫現有內容	指定當檔案系統中已存在目標 CSV 檔案時應採取的行動
Separator	無法使用	系統預設、逗號、分號、定位字元	系統預設	要在所指定 CSV 檔案中使用的欄分隔符號
Custom columns separator	否	文字值		要在 CSV 檔案中使用的自訂欄分隔符號
Use custom columns separator	無法使用	布林值	否	指定是否使用自訂欄分隔符號，或預先定義的

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	描述
寫入失敗	指示寫入 CSV 檔案時發生問題

取得檔案路徑部分

從表示檔案路徑的文字中擷取一或多個部分 (目錄、檔名、副檔名等)。

輸入參數

引數	選用	接受	預設值	描述
檔案路徑	否	檔案		要做為來源的檔案路徑

變數已產生

引數	類型​	描述
RootPath	檔案	來源檔案的根路徑
Directory	資料夾	來源檔案的目錄
FileName	文字值	來源檔案的名稱
FileNameNoExtension	文字值	來源檔案的檔案名稱 (不含副檔名)
FileExtension	文字值	來源檔案的副檔名 (例如 .doc)

例外狀況

例外狀況	描述
檔案路徑包含無效字元	指示檔案路徑不存在

取得暫存檔案

在磁片上建立唯一名稱的空白站存檔案，並取得檔案物件 (這是一種表示，並可存取該檔案及其所有資訊)。

輸入參數

此動作不需要任何輸入。

變數已產生

引數	類型​	描述
TempFile	檔案	暫存檔案物件

例外狀況

例外	描述
無法建立暫存檔案	指示建立暫存檔案時發生問題

將檔案轉換為 Base64

將檔案轉換為 Base64 編碼文字。

輸入參數

引數	選用	接受	預設值	描述
檔案路徑	否	檔案		要讀取的檔案路徑

變數已產生

引數	類型​	描述
Base64Text	文字值	Base64 編碼文字

例外狀況

例外狀況	描述
找不到檔案	指示檔案不存在
無法將檔案轉換為 Base64	指出提供的檔案無法轉換成 Base64 編碼文字

將 Base64 轉換為檔案

將 Base64 編碼文字轉換為檔案。

輸入參數

引數	選用	接受	預設值	描述
Base64 編碼文字	否	文字值		Base64 編碼文字
檔案路徑	否	檔案		要寫入的檔案
如果檔案存在	N/A	不執行任何動作、覆寫	不執行任何動作	指定當目的地資料夾中已存在相同名稱的檔案時應採取的行動

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	描述
無效的檔案目錄	指示目錄無效
無法將 Base64 轉換為檔案	指出提供的 Base64 編碼文字無法轉換成檔案

將檔案轉換為二進位資料

將檔案轉換為二進位資料。

輸入參數

引數	選用	接受	預設值	描述
檔案路徑	否	檔案		要讀取的檔案

變數已產生

引數	類型​	描述
BinaryData	文字值	要寫入的二進位資料

例外狀況

例外狀況	描述
找不到檔案	指示檔案不存在
無法將檔案轉換為二進位資料	指出無法將提供的檔案轉換為二進位資料

將二進位資料轉換為檔案

將二進位資料轉換為檔案。

輸入參數

引數	選用	接受	預設值	描述
二進位資料	否	文字值		二進位資料
檔案路徑	否	檔案		要寫入的檔案
如果檔案存在	無法使用	不執行任何動作、覆寫	不執行任何動作	指定當目的地資料夾中已存在相同名稱的檔案時應採取的行動

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	描述
無效的檔案目錄	指示目錄無效
無法將二進位檔案轉換為檔案	指出無法將提供的二進位資料轉換成檔案