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>]

Add-Content cmdlet 将内容追加到指定的项或文件中。 可以通过管道传入内容，也可以使用 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

Add-Content cmdlet 在当前目录中创建两个新文件。 Value 参数包含 Get-Date cmdlet 的输出。 PassThru 参数将添加的内容输出到管道。 由于没有其他 cmdlet 接收输出，因此它将显示在 PowerShell 控制台中。 Get-Content cmdlet 显示的更新文件为 DateTimeFile1.log。

此示例从文件获取内容，并将内容存储在变量中。 该变量用于将内容追加到另一个文件中。

$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txt

• Get-Content cmdlet 获取 CopyFromFile.txt 的内容，并将内容存储在 $From 变量中。
• Add-Content cmdlet 使用 CopyToFile.txt 变量的内容更新 $From 文件。
• Get-Content cmdlet 显示 CopyToFile.txt。

此示例从文件获取内容，并将其通过管道传递给 Add-Content cmdlet。

Get-Content -Path .\CopyFromFile.txt | Add-Content -Path .\CopyToFile.txt
Get-Content -Path .\CopyToFile.txt

Get-Content cmdlet 获取 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

• Add-Content cmdlet 使用 Path 和 Value 参数在当前目录中创建新文件。
• Get-Content cmdlet 获取现有文件 CopyFromFile.txt 的内容，并将其传递给 Value 参数。 Get-Content cmdlet 周围的括号可确保命令在 Add-Content 命令开始之前完成。
• Get-Content cmdlet 显示新文件 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

• New-Item cmdlet 使用 Path 和 ItemType 参数在当前目录中创建文件 IsReadOnlyTextFile.txt。
• Set-ItemProperty cmdlet 使用 Name 和 Value 参数将文件的 IsReadOnly 属性更改为 True。
• Get-ChildItem cmdlet 显示文件为空（0），并且具有只读属性（r）。
• Add-Content cmdlet 使用 Path 参数来指定文件。 Value 参数包括要追加到文件的文本字符串。 Force 参数将文本写入只读文件。
• Get-Content cmdlet 使用 Path 参数来显示文件的内容。

若要删除只读属性，请使用 Set-ItemProperty 命令，并将 值 参数设置为 False。

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

以下命令将单词“Done”添加到 *.txt 目录中所有 C:\Temp 文件的内容中。

Add-Content -Path C:\Temp\* -Filter *.txt -Value "Done"

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

可以通过管道将值传递给 Add-Content。

可以通过管道将凭据传递给 Add-Content。

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

使用 PassThru 参数时，此 cmdlet 返回表示内容的 System.String 对象。

PowerShell 包含以下与 Add-Content相关的别名：

• 窗户：

  • ac

• 通过管道将对象传递给 Add-Content时，该对象将转换为字符串，然后再添加到条目中。 对象类型确定字符串格式，但格式可能与对象的默认显示不同。 若要控制字符串格式，请使用发送 cmdlet 的格式参数。

• Add-Content cmdlet 用于处理由任何提供程序公开的数据。 若要列出会话中可用的提供程序，请键入 Get-PSProvider。 有关详细信息，请参阅 about_Providers。