Set-Content

語法

Set-Content
   [-Path] <string[]>
   [-Value] <Object[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-NoNewline]
   [-Encoding <FileSystemCmdletProviderEncoding>]
   [-Stream <string>]
   [<CommonParameters>]

Set-Content
   [-Value] <Object[]>
   -LiteralPath <string[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [-NoNewline]
   [-Encoding <FileSystemCmdletProviderEncoding>]
   [-Stream <string>]
   [<CommonParameters>]

Set-Content
   [-Path] <string[]>
   [-Value] <Object[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

Set-Content
   [-Value] <Object[]>
   -LiteralPath <string[]>
   [-PassThru]
   [-Filter <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Force]
   [-Credential <pscredential>]
   [-WhatIf]
   [-Confirm]
   [-UseTransaction]
   [<CommonParameters>]

Description

Set-Content 是字串處理 Cmdlet，可寫入新內容或取代檔案中的內容。 Set-Content 會取代現有的內容，而且與將內容附加至檔案的 Add-Content Cmdlet 不同。 若要將內容傳送至 Set-Content ，您可以使用 命令行上的 Value 參數，或透過管線傳送內容。

如果您需要建立下列範例的檔案或目錄，請參閱 New-Item。

範例

範例 1：取代目錄中多個檔案的內容

本範例會取代目前目錄中多個檔案的內容。

Get-ChildItem -Path .\Test*.txt

Test1.txt
Test2.txt
Test3.txt

Set-Content -Path .\Test*.txt -Value 'Hello, World'
Get-Content -Path .\Test*.txt

Hello, World
Hello, World
Hello, World

Cmdlet 會使用 Path 參數來列出以目前目錄中開頭Test*的檔案.txt。Get-ChildItem Cmdlet Set-Content 會使用 Path 參數來指定 Test*.txt 檔案。 Value 參數會提供文字字串 Hello， World 來取代每個檔案中的現有內容。 Cmdlet Get-Content 會使用 Path 參數來指定檔案， Test*.txt 並在 PowerShell 控制台中顯示每個檔案的內容。

範例 2：建立新的檔案並寫入內容

此範例會建立新的檔案，並將目前的日期和時間寫入檔案。

Set-Content -Path .\DateTime.txt -Value (Get-Date)
Get-Content -Path .\DateTime.txt

1/30/2019 09:55:08

Set-Content 會 使用Path 和 Value 參數，在目前目錄中建立名為 DateTime.txt 的新檔案。 Value 參數會使用 Get-Date 來取得目前的日期和時間。 Set-Content 將 DateTime 物件寫入檔案做為字串。 Cmdlet Get-Content 會使用Path參數，在PowerShell控制台中顯示DateTime.txt的內容。

範例 3：取代檔案中的文字

此命令會取代現有檔案內 Word 的所有實例。

Get-Content -Path .\Notice.txt

Warning
Replace Warning with a new word.
The word Warning was replaced.

(Get-Content -Path .\Notice.txt) |
    ForEach-Object {$_ -Replace 'Warning', 'Caution'} |
        Set-Content -Path .\Notice.txt
Get-Content -Path .\Notice.txt

Caution
Replace Caution with a new word.
The word Caution was replaced.

Cmdlet Get-Content 會使用 Path 參數來指定 目前目錄中的Notice.txt 檔案。 命令 Get-Content 會以括號包裝，讓命令在傳送至管線之前完成。

Notice.txt檔案的內容會向下傳送至 ForEach-Object Cmdlet。 ForEach-Object 會使用自動變數 $_ ，並將每個出現的 Warning 取代為 警告。 物件會向下傳送至 Cmdlet 的 Set-Content 管線。 Set-Content會使用Path參數來指定Notice.txt檔案，並將更新的內容寫入檔案。

最後一個 Get-Content Cmdlet 會在 PowerShell 控制台中顯示更新的檔案內容。

範例 4：搭配 Set-Content 使用篩選

您可以指定 Cmdlet 的篩選條件 Set-Content 。 使用篩選來限定 Path 參數時，您必須包含尾端星號 （*） 以指出路徑的內容。

下列命令會將目錄中所有 *.txt 檔案 C:\Temp 的內容設定為 空白值 。

Set-Content -Path C:\Temp\* -Filter *.txt -Value "Empty"

參數

-Confirm

-Credential

-Encoding

-Exclude

-Filter

-Force

-Include

-LiteralPath

-NoNewline

-PassThru

-Path

-Stream

-UseTransaction

-Value

-WhatIf

輸入

Object

您可以使用管線將包含專案新值的物件傳送至這個 Cmdlet。

輸出

None

根據預設，此 Cmdlet 不會傳回任何輸出。

String

當您使用 PassThru 參數時，這個 Cmdlet 會傳回代表內容的字串。

備註

Windows PowerShell 包含下列的 Set-Content別名：

• sc

• Set-Content 是針對字串處理所設計。 如果您使用管線將非字串物件傳送至 Set-Content，則會在寫入物件之前，將物件轉換成字串。 若要將物件寫入檔案，請使用 Out-File。

• Cmdlet Set-Content 的設計目的是要處理任何提供者所公開的數據。 若要列出工作階段中可用的提供者，請輸入 Get-PsProvider。 如需詳細資訊，請參閱 about_Providers。

相關連結

• about_Aliases
• about_Automatic_Variables.md
• about_Providers
• about_Transactions
• Add-Content
• Clear-Content
• Get-ChildItem
• Get-Content
• ForEach-Object
• 新增專案