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>]
说明
Add-Content
cmdlet 将内容追加到指定项或指定文件中。 可以通过管道传入内容,也可以使用 Value 参数进行指定。
如果需要为以下示例创建文件或目录,请参阅 New-Item。
示例
示例 1:将某个字符串添加到所有文本文件中,但有例外
此示例将一个值追加到当前目录中的文本文件,但会根据文件名来排除文件。
Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'
Path 参数指定当前目录中的所有 .txt
文件,但 Exclude 参数将忽略与指定模式匹配的文件名。 Value 参数指定写入到文件的文本字符串。
使用 Get-Content 显示这些文件的内容。
示例 2:将日期添加到指定文件的末尾
此示例将日期追加到当前目录中的文件,并在 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
。
示例 3:将指定文件的内容添加到另一个文件
此示例从文件获取内容,并将内容存储在一个变量中。 该变量用于将内容追加到另一个文件中。
$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 使用$From
变量的内容更新CopyToFile.txt
文件。Get-Content
cmdlet 显示 CopyToFile.txt。
示例 4:使用管道将指定文件的内容添加到另一个文件
此示例从文件获取内容,并通过管道将其传递给 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
。
示例 5:创建新文件并复制内容
此示例创建一个新文件,并将现有文件的内容复制到新文件中。
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
的内容。
示例 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.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
命令并将 Value 参数设置为 False
。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
注意
随同 PowerShell 一起安装的任何提供程序都不支持此参数。 要模拟其他用户,或在运行此 cmdlet 时提升凭据,请使用 Invoke-Command。
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
将 UTF-32 与 big-endian 字节顺序配合使用。Byte
将一组字符编码为一个字节序列。Default
使用与系统的活动代码页(通常是 ANSI)对应的编码。Oem
使用与系统的当前 OEM 代码页对应的编码。String
与 Unicode 相同。Unicode
将 UTF-16 与 little-endian 字节顺序配合使用。Unknown
与 Unicode 相同。UTF7
使用 UTF-7。UTF8
使用 UTF-8。UTF32
将 UTF-32 与 little-endian 字节顺序配合使用。
Encoding 是 FileSystem 提供程序添加到 Add-Content
cmdlet 的动态参数。 此参数仅在文件系统驱动器中有效。
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
以字符串数组的形式指定此 cmdlet 将在操作中排除的项。 此参数值使 Path 参数有效。 请输入路径元素或模式,例如 *.txt
。 允许使用通配符。 仅当该命令包括项的内容时(例如 C:\Windows\*
,其中通配符指定 C:\Windows
目录的内容),Exclude 参数才有效。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
指定用于限定 Path 参数的筛选器。 FileSystem 提供程序是唯一支持使用筛选器的已安装 PowerShell 提供程序。 可以在 about_Wildcards 中找到 FileSystem 筛选器语言的语法。 筛选器比其他参数更有效,因为提供程序是在 cmdlet 获取对象时应用筛选器,而不是在检索对象后再让 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
指定此 cmdlet 将在操作中包含的一个项或多个项(作为一个字符串数组)。 此参数值使 Path 参数有效。 请输入路径元素或模式,例如 "*.txt"
。 允许使用通配符。 仅当该命令包括项的内容时(例如 C:\Windows\*
,其中通配符指定 C:\Windows
目录的内容),Include 参数才有效。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
指定一个或多个位置的路径。 LiteralPath 的值严格按照所键入的形式使用。 不会将任何字符解释为通配符。 如果路径包括转义符,请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。
有关详细信息,请参阅 about_Quoting_Rules。
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
指定要添加的内容。 键入用引号引起来的字符串,例如“This data is for internal use only”;或指定包含内容的对象,例如 Get-Date
生成的 DateTime 对象。
无法通过键入文件路径来指定文件内容,因为路径只是一个字符串。
可以使用 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 |
输入
可以通过管道将值传递给 Add-Content
。
可以通过管道将凭据传递给 Add-Content
。
输出
None
默认情况下,此 cmdlet 不返回任何输出。
使用 PassThru 参数时,此 cmdlet 返回表示内容的 System.String 对象。
备注
Windows PowerShell 包含以下 Add-Content
别名:
ac
在将对象通过管道传送给
Add-Content
时,该对象将先转换为字符串,然后再添加到项。 对象类型决定字符串格式,但该格式可能不同于该对象的默认显示。 若要控制字符串格式,请使用发送 cmdlet 的格式设置参数。Add-Content
cmdlet 用于处理由任何提供程序公开的数据。 若要列出会话中可用的提供程序,请键入Get-PSProvider
。 有关详细信息,请参阅 about_Providers。