Add-Content
向指定的项中添加内容，如向文件中添加字词。
语法
Add-Content
[-Path] <string[]>
[-Value] <Object[]>
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-NoNewline]
[-Encoding <FileSystemCmdletProviderEncoding>]
[-Stream <string>]
[<CommonParameters>]Add-Content
[-Value] <Object[]>
-LiteralPath <string[]>
[-PassThru]
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[-NoNewline]
[-Encoding <FileSystemCmdletProviderEncoding>]
[-Stream <string>]
[<CommonParameters>]说明
cmdlet Add-Content 将内容追加到指定的项或文件中。 可以通过在命令中键入内容或通过指定包含内容的对象来指定内容。
如果需要为以下示例创建文件或目录，请参阅 New-Item。
示例
示例 1：向所有文本文件添加字符串，但有一个例外
此示例将值追加到当前目录中的文本文件，但根据文件名称排除文件。
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'cmdlet Add-Content 使用 Path 参数指定当前目录中的所有 .txt 文件。 Exclude 参数将忽略与指定模式匹配的文件名。 Value 参数指定写入文件的文本字符串。
使用 Get-Content 显示这些文件的内容。
示例 2：将日期添加到指定文件的末尾
此示例将日期追加到当前目录中的文件，并在 PowerShell 控制台中显示日期。
Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThru
Get-Content -Path .\DateTimeFile1.logcmdlet Add-Content 使用 Path 和 Value 参数在当前目录中创建两个新文件。 Value 参数指定获取日期的 Get-Date cmdlet 并将日期Add-Content传递给 。 cmdlet Add-Content 将日期写入每个文件。 PassThru 参数传递表示日期对象的 对象。 由于没有其他 cmdlet 可以接收传递的对象，因此它将显示在 PowerShell 控制台中。 cmdlet Get-Content 显示更新的文件，DateTimeFile1.log。
示例 3：将指定文件的内容添加到另一个文件
此示例从文件获取内容，并将该内容追加到另一个文件中。
Add-Content -Path .\CopyToFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\CopyToFile.txtcmdlet Add-Content 使用 Path 参数指定当前目录中的新文件，CopyToFile.txt。 Value 参数使用 Get-Content cmdlet 获取文件的内容，CopyFromFile.txt。 cmdlet 周围的 Get-Content 括号可确保命令在命令开始之前 Add-Content 完成。 Value 参数将Add-Content传递给 。 cmdlet Add-Content 将数据追加到 CopyToFile.txt 文件。 cmdlet Get-Content 显示更新的文件，CopyToFile.txt。
示例 4：使用变量将指定文件的内容添加到另一个文件
此示例从文件获取内容，并将内容存储在变量中。 变量用于将内容追加到另一个文件中。
$From = Get-Content -Path .\CopyFromFile.txt
Add-Content -Path .\CopyToFile.txt -Value $From
Get-Content -Path .\CopyToFile.txtcmdlet Get-Content 获取 CopyFromFile.txt 的内容，并将内容存储在 变量中 $From 。 cmdlet Add-Content 使用 Path 参数指定当前目录中的 CopyToFile.txt 文件。 Value 参数使用 $From 变量并将内容传递给 Add-Content。 cmdlet Add-Content 更新 CopyToFile.txt 文件。 cmdlet Get-Content 显示 CopyToFile.txt。
示例 5：Create新文件和复制内容
此示例创建一个新文件，并将现有文件的内容复制到新文件中。
Add-Content -Path .\NewFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\NewFile.txtcmdlet Add-Content 使用 Path 和 Value 参数在当前目录中创建新文件。 Value 参数使用 Get-Content cmdlet 获取现有文件的内容，CopyFromFile.txt。 cmdlet 周围的 Get-Content 括号可确保命令在命令开始之前 Add-Content 完成。 Value 参数传递更新 NewFile.txt 文件的内容Add-Content。 cmdlet Get-Content 显示新文件的内容，NewFile.txt。
示例 6：将内容添加到只读文件
即使 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.txtcmdlet 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的 命令。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
指定有权执行此操作的用户帐户。 默认为当前用户。
键入用户名，例如 User01 或 Domain01\User01，或输入 PSCredential 对象，例如 cmdlet Get-Credential 生成的对象。 如果键入用户名，则将提示你输入密码。
警告
随 PowerShell 一起安装的任何提供程序都不支持此参数。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Encoding
指定目标文件的编码类型。 默认值为 Default。
此参数的可接受值如下所示：
- Ascii 使用 ASCII (7 位) 字符集。
- BigEndianUnicode 将 UTF-16 与 big-endian 字节顺序一起使用。
- BigEndianUTF32 使用具有 big-endian 字节顺序的 UTF-32。
- 字节 将一组字符编码为字节序列。
- 默认 使用与系统的活动代码页相对应的编码 (通常为 ANSI) 。
- Oem 使用对应于系统的当前 OEM 代码页的编码。
- 字符串 与 Unicode 相同。
- Unicode 将 UTF-16 与 little-endian 字节顺序一起使用。
- 未知 与 Unicode 相同。
- UTF7 使用 UTF-7。
- UTF8 使用 UTF-8。
- UTF32 将 UTF-32 与 little-endian 字节顺序一起使用。
编码是 FileSystem 提供程序添加到 cmdlet 的 Add-Content 动态参数。 此参数仅在文件系统驱动器中有效。
| Type: | FileSystemCmdletProviderEncoding |
| Accepted values: | ASCII, BigEndianUnicode, BigEndianUTF32, Byte, Default, OEM, String, Unicode, Unknown, UTF7, UTF8, UTF32 |
| Position: | Named |
| Default value: | Default |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Exclude
忽略指定项。 此参数值使 Path 参数有效。 输入路径元素或模式，例如 *.txt。 允许使用通配符。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Filter
以提供程序的格式或语言指定筛选器。 此参数值使 Path 参数有效。 筛选器的语法（包括通配符的使用）取决于提供程序。 筛选器 比其他参数更有效，因为提供程序在检索对象时会应用筛选器。 否则，PowerShell 会在检索对象后处理筛选器。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Force
覆盖只读属性，从而允许你向只读文件中添加内容。 例如，Force 将覆盖只读属性或创建目录来完成文件路径，但它不会尝试更改文件权限。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Include
只添加指定项。 此参数值使 Path 参数有效。 输入路径元素或模式，例如 *.txt。 允许使用通配符。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-LiteralPath
指定用于接收其他内容的项的路径。 不同于 Path，LiteralPath 的值严格按照所键入的形式使用。 不会将任何字符解释为通配符。 如果路径包括转义符，请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。
| Type: | String[] |
| Aliases: | PSPath |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NoNewline
指示此 cmdlet 不会向内容添加新行或回车符。
输入对象的字符串表示形式串联成输出。 在输出字符串之间不插入空格或换行符。 未在最后一个输出字符串后面添加换行符。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
返回一个表示所添加内容的对象。 默认情况下，此 cmdlet 将不产生任何输出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
指定用于接收其他内容的项的路径。 允许使用通配符。 如果指定多个路径，请使用逗号分隔这些路径。
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Stream
指定内容的备用数据流。 如果该流不存在，则此 cmdlet 将创建它。 不支持通配符。
Stream是 FileSystem 提供程序添加到 Add-Content的动态参数。 此参数仅在文件系统驱动器中有效。
可以使用 Add-Content cmdlet 更改 Zone.Identifier 备用数据流的内容。 但是，若要取消安全检查（该安全检查可阻止从 Internet 下载的文件），则不建议使用此方法。 如果验证下载的文件是否安全，请使用 Unblock-File cmdlet。
此参数是在 PowerShell 3.0 中引入的。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseTransaction
在活动事务中使用该命令。 仅当正在执行事务时，此参数才有效。 有关详细信息，请参阅 about_Transactions。
| Type: | SwitchParameter |
| Aliases: | usetx |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Value
指定要添加的内容。 键入带引号的字符串，例如 ，此数据仅供内部使用，或指定包含内容的对象，例如生成的 DateTime 对象 Get-Date 。
无法通过键入文件路径来指定文件的内容，因为路径只是一个字符串。
可以使用 Get-Content 命令获取内容并将其传递给 Value 参数。
| Type: | Object[] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
System.Object, System.Management.Automation.PSCredential
可以通过管道将值、路径或凭据传递给 Set-Content。
输出
None or System.String
使用 PassThru 参数时， Add-Content 会生成表示内容的 System.String 对象。 否则，此 cmdlet 将不生成任何输出。
备注
通过管道将对象传递给 Add-Content时，对象在添加到项之前会将其转换为字符串。 对象类型决定字符串格式，但该格式可能不同于该对象的默认显示。 若要控制字符串格式，请使用发送 cmdlet 的格式设置参数。
还可以通过其内置别名 ac来引用 Add-Content 。 有关详细信息，请参阅 about_Aliases。
该 Add-Content cmdlet 旨在处理任何提供程序公开的数据。 若要列出会话中可用的提供程序，请键入 Get-PSProvider。 有关详细信息，请参阅 about_Providers。