PowerShell Add-Content| PowerShell附加到文件

本文概述

• 句法
• 参数
• 例子

Add-Content cmdlet将内容附加到指定的项目或文件, 例如将单词添加到文件。我们可以通过在cmdlet中键入内容或指定包含内容的对象来指定内容。

句法

Add-Content 
[-Path <string[]>] 
[-Credential <pscredential>] 
[-WhatIf] 
[-Confirm]
[-Value <Object[]>] 
[-PassThru] 
[-Filter <string>] 
[-Include <string[]>] 
[-Exclude <string[]>] 
[-Force] 
[-UseTransaction] 
[-NoNewline] 
[-Encoding {Unknown | String | Unicode | Byte | BigEndianUnicode | UTF8 | UTF7 | UTF32 | Ascii | Default | Oem |BigEndianUTF32}] 
[-Stream <string>]  
[<CommonParameters>]

Add-Content 
[-Value <Object[]>]
[ -LiteralPath <string[]>]
[-Credential <pscredential>] 
[-WhatIf] 
[-Confirm]
[-PassThru] 
[-Filter <string>] 
[-Include <string[]>]
[-Exclude <string[]>] 
[-Force] 
[-UseTransaction] 
[-NoNewline]
[-Encoding {Unknown | String | Unicode | Byte | BigEndianUnicode | UTF8 | UTF7 | UTF32 | Ascii | Default | Oem |BigEndianUTF32}] 
[-Stream <string>]  
[<CommonParameters>]

参数

-路径

-Path参数用于指定接收附加内容的项目的路径。接受通配符。 cmdlet中提供的路径必须是项目的路径, 而不是容器的路径。如果我们指定多个路径, 则可以使用逗号分隔路径。

文学路径

-LiteralPath参数用于指定一个或多个位置的路径。它的值与键入时完全一样。如果路径包含转义符, 则将其用单引号引起来。单引号告诉Windows PowerShell, 它不应将任何字符解释为转义序列。 cmdlet中没有字符, 该字符被解释为通配符。

-如果

-WhatIf参数显示”如果cmdlet运行会发生什么”。该cmdlet将不会执行。

-确认

-Confirm参数在运行cmdlet之前提示确认。

-值

-Value参数用于指定要添加的内容。我们不能通过输入文件的路径来指定文件的内容, 因为路径只是一个字符串。我们可以使用Get-content cmdlet来获取内容并将其传递给-Value参数。

直通

-PassThru参数返回一个代表添加内容的对象。默认情况下, 此参数不生成任何输出。

-过滤

-Filter参数指定用于限定-Path参数的过滤器。 FileSystem提供程序是唯一支持使用过滤器的PowerShell提供程序。此参数效率更高, 因为提供程序在cmdlet获取对象时应用筛选器, 而不是让Powershell在访问对象后筛选对象。

-包括

此cmdlet包括在操作中的项目被指定为字符串数组。 -Include参数的值限定-Path参数。输入模式或路径元素, 例如* .txt。接受通配符。仅当cmdlet包含项的内容(例如C：\ *, 通配符’*’用于指定C：目录的内容)时, -Exclude参数才有效。

-排除

此cmdlet在操作中排除的项目指定为字符串数组。 -Exclude参数的值限定-Path参数。输入模式或路径元素, 例如* .txt。接受通配符。仅当cmdlet包含项的内容(例如C：\ *, 通配符’*’用于指定C：目录的内容)时, -Exclude参数才有效。

-力

-Force参数允许将内容添加到只读文件, 并覆盖只读属性。

-编码

-Encoding参数用于指定目标文件的编码类型。默认情况下, 其值为UTF8NoBOM。它是一个动态参数, FileSystem提供程序将其添加到Add-Content cmdlet。 -Encoding参数仅在文件系统驱动器中起作用。

以下是此参数可接受的值：

• ASCII：此值使用ASCII(7位)字符集的编码。
• OEM：此值使用MS-DOS和控制台程序的默认编码。
• UTF8：以UTF-8格式编码。
• UTF8BOM：它以字节序标记(BOM)以UTF-8格式编码
• UTF8NoBOM：它以UTF-8格式编码, 没有字节顺序标记(BOM)
• Unicode：使用小尾数字节顺序以UTF-16格式编码。
• BigEndianUnicode：使用big-endian字节顺序以UTF-16格式编码。
• UTF32：此值以UTF-32格式编码。
• UTF7：此值以UTF-7格式编码。

-NoNewLine

-NoNewLine参数指示此cmdlet不会向内容添加新行或回车。在输出字符串之间不会插入任何换行符或空格, 并且在最后一个输出字符串之后也不会添加任何换行符。

-流

-Stream参数用于为内容指定备用数据流。如果流不存在, 它将创建它。接受通配符。

例子

示例1：将字符串添加到指定文件

在此示例中, 该cmdlet将值附加到当前目录中的指定文件。

示例2：将字符串添加到所有文本文件

在此示例中, 该cmdlet将值附加到当前目录中的所有文本文件。

示例3：在指定文件的末尾添加一个日期

此示例中的cmdlet将日期追加到当前目录中的指定文件, 并在PowerShell控制台中显示日期。

示例4：将指定文件的内容添加到另一个文件

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

Get-Content cmdlet接收File1.txt的内容, 并将其存储在$ get变量中。

Add-Content cmdlet使用$ get变量的内容更新File2.txt文件。 Get-Content cmdlet显示File2.txt。

示例5：创建一个新文件并复制内容

本示例创建一个新文件, 并将现有文件的内容复制到新文件中。