Set-Content

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

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

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

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

Set-Content 是一个字符串处理 cmdlet，用于写入新内容或替换文件中的内容。 Set-Content 替换现有内容，不同于将内容追加到文件的 Add-Content cmdlet。 若要将内容发送到 Set-Content 可以使用命令行上的 Value 参数或通过管道发送内容。

如果需要为以下示例创建文件或目录，请参阅 New-Item。

此示例替换当前目录中多个文件的内容。

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

Get-ChildItem cmdlet 使用 Path 参数列出以当前目录中 开头的 Test* 文件。 Set-Content cmdlet 使用 Path 参数来指定 Test*.txt 文件。 Value 参数提供替换每个文件中现有内容的文本字符串 Hello， World。 Get-Content cmdlet 使用 Path 参数来指定 Test*.txt 文件并在 PowerShell 控制台中显示每个文件的内容。

此示例创建一个新文件，并将当前日期和时间写入文件。

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 对象作为字符串写入文件。 Get-Content cmdlet 使用 Path 参数在 PowerShell 控制台中显示 DateTime.txt 的内容。

此命令替换现有文件中单词的所有实例。

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.

Get-Content cmdlet 使用 Path 参数指定当前目录中的 Notice.txt 文件。 Get-Content 命令用括号包装，以便命令在管道发送之前完成。

Notice.txt 文件的内容将管道向下发送到 ForEach-Object cmdlet。 ForEach-Object 使用自动变量 $_，并将 警告 的每个匹配项替换为 警告。 对象将管道向下发送到 Set-Content cmdlet。 Set-Content 使用 Path 参数指定 Notice.txt 文件并将更新的内容写入文件。

最后一个 Get-Content cmdlet 在 PowerShell 控制台中显示更新的文件内容。

可以为 Set-Content cmdlet 指定一个筛选器。 使用筛选器限定 Path 参数时，需要包含尾随星号（*），以指示路径的内容。

以下命令将 *.txt 目录中所有 C:\Temp 文件的内容设置为空 值。

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

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

可以通过管道将包含项的新值的对象传递给此 cmdlet。

默认情况下，此 cmdlet 不返回任何输出。

使用 PassThru 参数时，此 cmdlet 返回表示内容的字符串。

• Set-Content 专为字符串处理而设计。 如果将非字符串对象通过管道传递给 Set-Content，则会在编写对象之前将该对象转换为字符串。 若要将对象写入文件，请使用 Out-File。
• Set-Content cmdlet 用于处理由任何提供程序公开的数据。 若要列出会话中可用的提供程序，请键入 Get-PSProvider。 有关详细信息，请参阅 about_Providers。