Add-Content
將內容新增至指定的專案,例如將單字新增至檔案。
Add-Content
[-Path] <string[]>
[-Value] <Object[]>
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-NoNewline]
[-Encoding <Encoding>]
[-AsByteStream]
[-Stream <string>]
[<CommonParameters>]
Add-Content
[-Value] <Object[]>
-LiteralPath <string[]>
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-NoNewline]
[-Encoding <Encoding>]
[-AsByteStream]
[-Stream <string>]
[<CommonParameters>]
Cmdlet 會將 Add-Content
內容附加至指定的項目或檔案。 內容可以從管線傳入,或使用 Value 參數來指定。
如果您需要建立下列範例的檔案或目錄,請參閱 New-Item。
本範例會將值附加至目前目錄中的文本檔,但會根據其檔名排除檔案。
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'
Path 參數會指定目前目錄中的所有.txt
檔案,但 Exclude 參數會忽略符合指定模式的檔名。 Value 參數會指定寫入檔案的文字字串。
使用 Get-Content 來顯示這些檔案的內容。
本範例會將日期附加至目前目錄中的檔案,並在 PowerShell 控制台中顯示日期。
Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThru
Get-Content -Path .\DateTimeFile1.log
Tuesday, May 14, 2019 8:24:27 AM
Tuesday, May 14, 2019 8:24:27 AM
5/14/2019 8:24:27 AM
Cmdlet 會在 Add-Content
目前目錄中建立兩個新的檔案。 Value 參數包含 Cmdlet 的Get-Date
輸出。 PassThru 參數會將新增的內容輸出至管線。 因為沒有其他 Cmdlet 可接收輸出,所以會顯示在 PowerShell 控制台中。 Cmdlet Get-Content
會顯示更新的檔案 DateTimeFile1.log
。
這個範例會從檔案取得內容,並將內容儲存在變數中。 變數是用來將內容附加至另一個檔案。
$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt
- Cmdlet
Get-Content
會取得 的內容,並將內容CopyFromFile.txt
儲存在變數中$From
。 - Cmdlet 會
Add-Content
使用 變數的內容$From
來更新CopyToFile.txt
檔案。 - Cmdlet
Get-Content
會顯示CopyToFile.txt。
這個範例會從檔案取得內容,並將它傳送至 Add-Content
Cmdlet。
Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txt
Get-Content -Path .\CopyToFile.txt
Cmdlet Get-Content
會取得 的內容 CopyFromFile.txt
。 結果會透過管線傳送至 Add-Content
Cmdlet,以更新 CopyToFile.txt
。
最後一個 Get-Content
Cmdlet 會顯示 CopyToFile.txt
。
此範例會建立新的檔案,並將現有檔案的內容複製到新檔案中。
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\NewFile.txt
- Cmdlet
Add-Content
會使用 Path 和 Value 參數,在目前目錄中建立新的檔案。 - Cmdlet
Get-Content
會取得現有檔案的內容,CopyFromFile.txt
並將它傳遞至 Value 參數。 Cmdlet 周圍的Get-Content
括號可確保命令在命令開始之前Add-Content
完成。 - Cmdlet
Get-Content
會顯示新檔案的內容。NewFile.txt
此命令會將值新增至檔案,即使 IsReadOnly 檔案屬性設定為 True也一樣。 建立唯讀檔案的步驟包含在範例中。
New-Item -Path .\IsReadOnlyTextFile.txt -ItemType File
Set-ItemProperty -Path .\IsReadOnlyTextFile.txt -Name IsReadOnly -Value $True
Get-ChildItem -Path .\IsReadOnlyTextFile.txt
Add-Content -Path .\IsReadOnlyTextFile.txt -Value 'Add value to read-only text file' -Force
Get-Content -Path .\IsReadOnlyTextFile.txt
Mode LastWriteTime Length Name
---- ------------- ------ ----
-ar-- 1/28/2019 13:35 0 IsReadOnlyTextFile.txt
- Cmdlet
New-Item
會使用 Path 和 ItemType 參數,在目前目錄中建立檔案IsReadOnlyTextFile.txt
。 - Cmdlet
Set-ItemProperty
會使用 Name 和 Value 參數,將檔案的 IsReadOnly 屬性變更為 True。 - Cmdlet
Get-ChildItem
會顯示檔案是空的 (0
),而且具有只讀屬性 (r
)。 - Cmdlet
Add-Content
會使用 Path 參數來指定檔案。 Value 參數包含要附加至檔案的文字字串。 Force 參數會將文字寫入唯讀檔案。 - Cmdlet
Get-Content
會使用 Path 參數來顯示檔案的內容。
若要移除唯讀屬性,請使用 Set-ItemProperty
命令並將 Value 參數設定為 False
。
您可以指定 Cmdlet 的篩選條件 Add-Content
。 使用篩選來限定 Path 參數時,您必須包含尾端星號 (*
) 以指出路徑的內容。
下列命令會將 「Done」 這個字新增目錄中所有 *.txt
檔案 C:\Temp
的內容。
Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"
指定內容應讀取為位元組數據流。 此參數是在 PowerShell 6.0 中引進的。
當您搭配 Encoding 參數使用 AsByteStream 參數時,就會發生警告。 AsByteStream 參數會忽略任何編碼,並將輸出當做位元組數據流傳回。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
執行 Cmdlet 之前先提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
注意
任何與 PowerShell 一起安裝的提供者都不支援此參數。 若要模擬其他使用者,或在執行此 Cmdlet 時提升您的認證,請使用 Invoke-Command。
類型: | PSCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
指定目標檔案的編碼類型。 預設值是 utf8NoBOM
。
編碼是 FileSystem 提供者新增至 Cmdlet 的 Add-Content
動態參數。 此參數僅適用於檔案系統磁碟驅動器。
此參數可接受的值如下:
ascii
:使用 ASCII (7 位) 字元集的編碼方式。ansi
:針對目前文化特性的 ANSI 代碼頁,使用 的編碼方式。 此選項已在PowerShell 7.4中新增。bigendianunicode
:使用 big-endian 位元組順序以 UTF-16 格式編碼。bigendianutf32
:使用 big-endian 位元組順序以 UTF-32 格式編碼。oem
:使用 MS-DOS 和控制台程式的預設編碼方式。unicode
:使用位元組順序以UTF-16格式編碼。utf7
:以 UTF-7 格式編碼。utf8
:以 UTF-8 格式編碼。utf8BOM
:使用位元節順序標記以 UTF-8 格式編碼 (BOM)utf8NoBOM
:以 UTF-8 格式編碼,不含位元組順序標記 (BOM)utf32
:以 UTF-32 格式編碼。
從 PowerShell 6.2 開始,Encoding 參數也允許已註冊代碼頁的數值識別元(例如 -Encoding 1251
)或已註冊代碼頁的字串名稱(例如 )。-Encoding "windows-1251"
如需詳細資訊,請參閱 Encoding.CodePage 的 .NET 檔。
從 PowerShell 7.4 開始,您可以使用 Ansi
Encoding 參數的值,傳遞目前文化特性 ANSI 代碼頁的數值標識碼,而不需要手動指定它。
注意
不再建議使用UTF-7* 。 自 PowerShell 7.1 起,如果您為 Encoding 參數指定utf7
,則會撰寫警告。
類型: | Encoding |
接受的值: | ASCII, BigEndianUnicode, BigEndianUTF32, OEM, Unicode, UTF7, UTF8, UTF8BOM, UTF8NoBOM, UTF32 |
Position: | Named |
預設值: | UTF8NoBOM |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
指定此 Cmdlet 在作業中排除的專案或專案,做為字串陣列。 此參數的值會 限定Path 參數。 輸入路徑專案或模式,例如 *.txt
。 允許通配符。 Exclude 參數只有在命令包含項目的內容時有效,例如 C:\Windows\*
,通配符會指定目錄的內容C:\Windows
。
類型: | String[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | True |
指定篩選條件以限定 Path 參數。 FileSystem 提供者是唯一支援使用篩選器的已安裝 PowerShell 提供者。 您可以在 about_Wildcards 中找到 FileSystem 篩選語言的語法。 篩選比其他參數更有效率,因為提供者會在 Cmdlet 取得物件時套用它們,而不是在擷取對象之後讓 PowerShell 篩選物件。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | True |
覆寫唯讀屬性,讓您將內容新增至只讀檔案。 例如, Force 會覆寫唯讀屬性,但不會變更檔案許可權。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
指定此 Cmdlet 包含在作業中的專案,做為字串陣列。 此參數的值會 限定Path 參數。 輸入路徑專案或模式,例如 "*.txt"
。 允許通配符。 Include 參數只有在命令包含項目的內容時有效,例如 C:\Windows\*
,其中通配符會指定目錄的內容C:\Windows
。
類型: | String[] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | True |
指定一或多個位置的路徑。 LiteralPath 的值會完全依照其類型一樣使用。 不會將任何字元解譯為通配符。 如果路徑包含逸出字元,請以單引弧括住它。 單引號會告知PowerShell不要將任何字元解譯為逸出序列。
如需詳細資訊,請參閱 about_Quoting_Rules。
類型: | String[] |
別名: | PSPath, LP |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
表示此 Cmdlet 不會將新行或歸位字元新增至內容。
輸入物件的字串表示會串連以形成輸出。 輸出字串之間不會插入空格或換行符。 最後一個輸出字串之後不會新增任何換行符。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
傳回物件,表示新增的內容。 根據預設,此 Cmdlet 不會產生任何輸出。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
指定接收其他內容之項目的路徑。 允許通配符。 路徑必須是項目的路徑,而不是容器的路徑。 例如,您必須指定一或多個檔案的路徑,而不是目錄的路徑。 如果您指定多個路徑,請使用逗號來分隔路徑。
類型: | String[] |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | True |
注意
此參數僅適用於 Windows。
指定內容的替代數據流。 如果數據流不存在,此 Cmdlet 會建立它。 不支援通配符。
Stream 是 FileSystem 提供者新增至 Add-Content
的動態參數。 此參數僅適用於檔案系統磁碟驅動器。
您可以使用 Add-Content
Cmdlet 來變更任何替代資料串流的內容, 例如 Zone.Identifier
。 不過,我們不建議這樣做,以消除封鎖從因特網下載之檔案的安全性檢查。 如果您確認下載的檔案是安全的,請使用 Unblock-File
Cmdlet。
此參數是在 PowerShell 3.0 中引進的。 從 PowerShell 7.2 起, Add-Content
可以將目標設為檔案和目錄上的替代數據流。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
指定要新增的內容。 輸入引號字串,例如 此數據僅供內部使用,或指定包含內容的物件,例如 產生的 DateTime 物件 Get-Date
。
您無法輸入檔案路徑來指定檔案的內容,因為路徑只是字串。
您可以使用 Get-Content
命令來取得內容,並將其傳遞至 Value 參數。
類型: | Object[] |
Position: | 1 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 未執行。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
您可以使用管線將值傳送至 Add-Content
。
您可以使用管線將認證傳送至 Add-Content
。
None
根據預設,此 Cmdlet 不會傳回任何輸出。
當您使用 PassThru 參數時,這個 Cmdlet 會 傳回代表內容的 System.String 物件。
PowerShell 包含下列的 Add-Content
別名:
Windows:
ac
當您使用管線將 對象傳送至
Add-Content
時,物件會先轉換成字串,再將它新增至專案。 物件類型會決定字串格式,但格式可能與對象的預設顯示不同。 若要控制字串格式,請使用傳送 Cmdlet 的格式參數。Cmdlet
Add-Content
的設計目的是要處理任何提供者所公開的數據。 若要列出工作階段中可用的提供者,請輸入Get-PSProvider
。 如需詳細資訊,請參閱 about_Providers。