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 将内容追加到指定的项或文件中。 您可以通过在命令中键入内容或指定包含内容的对象来指定内容。

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

本示例将一个值追加到当前目录中的文本文件，但会根据其文件名排除文件。

Add-Content -Path .\*.txt -Exclude help* -Value 'End of file'

cmdlet Add-Content 使用 Path 参数指定当前目录中的所有 .txt 文件。 Exclude 参数将忽略与指定模式匹配的文件名。 Value 参数指定写入文件的文本字符串。

使用 Get-Content 来显示这些文件的内容。

本示例将日期追加到当前目录中的文件，并在 PowerShell 控制台中显示日期。

Add-Content -Path .\DateTimeFile1.log, .\DateTimeFile2.log -Value (Get-Date) -PassThru
Get-Content -Path .\DateTimeFile1.log

cmdlet Add-Content 使用 Path 和 Value 参数在当前目录中创建两个新文件。 Value 参数指定Get-Date用于获取日期的 cmdlet 并将日期传递给 Add-Content. 该 Add-Content cmdlet 将日期写入每个文件。 PassThru 参数传递表示日期对象的对象。 由于没有其他 cmdlet 来接收传递的对象，因此它将显示在 PowerShell 控制台中。 cmdlet Get-Content 显示更新的文件 DateTimeFile1.log。

此示例从一个文件中获取内容，并将该内容附加到另一个文件中。

Add-Content -Path .\CopyToFile.txt -Value (Get-Content -Path .\CopyFromFile.txt)
Get-Content -Path .\CopyToFile.txt

cmdlet Add-Content 使用 Path 参数指定当前目录中的新文件 CopyToFile.txt。 Value 参数使用 Get-Content cmdlet 获取文件的内容，CopyFromFile.txt. Get-Content cmdlet 周围的括号可确保命令在 Add-Content 命令开始之前完成。 将 Value 参数传递给 Add-Content。 该 Add-Content cmdlet 将数据附加到 CopyToFile.txt 文件。 cmdlet Get-Content 显示更新的文件 CopyToFile.txt。

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

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

cmdlet Get-Content 获取 CopyFromFile.txt 的内容并将内容存储在变量中 $From 。 cmdlet Add-Content 使用 Path 参数指定当前目录中的 CopyToFile.txt 文件。 参数的 Value 使用变量 $From 并将内容 Add-Content传递给 。 cmdlet Add-Content 更新 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 参数在当前目录中创建新文件。 Value 参数使用 Get-Content cmdlet 获取现有文件 CopyFromFile.txt的内容。 Get-Content cmdlet 周围的括号可确保命令在 Add-Content 命令开始之前完成。 Value 参数传递Add-Content将 NewFile.txt 文件更新到的内容。 该 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

cmdlet New-Item 使用 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。

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

您可以通过管道将值、路径或凭据传递给 Set-Content。

使用 PassThru 参数时，Add-Content 生成表示内容的 System.String 对象。 否则，此 cmdlet 不会生成任何输出。

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

还可以通过其内置别名 Add-Content来引用 ac。 有关详细信息，请参阅 about_Aliases。

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