PowerShell set-content命令

PowerShell Set-Content用于将新内容写入或替换文件中已经存在的内容。 它不同于Add-content cmdlet，Add-content将内容附加到文件。 可以在Set-Content cmdlet命令行上使用-Value参数将内容发送到文件，也可以通过管道发送内容。 sc是此cmdlet的别名。

语法

示例1

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

示例2

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

参数

-Path - 此参数用于指定项目当前位置的路径，接受通配符。 默认情况下，其值为当前目录。
-LiteralPath - 此参数用于指定位置的路径。 它的值与键入时完全一样。 如果路径包含转义符，则将其用单引号引起来。单引号告诉Windows PowerShell，它不应将任何字符解释为转义序列。
-Destination - 此参数用于指定复制项目的位置的路径。 默认情况下，其值为当前目录。 可以使用通配符，但是输出必须指定一个位置。
在-Destination - 此参数的值中指定一个新名称，以重命名要移动的项目。
-Force - 此参数用于强制执行命令而不要求用户确认。
-Filter - 此参数指定用于限定-Path参数的过滤器。 FileSystem提供程序是唯一支持使用过滤器的PowerShell提供程序。 此参数效率更高，因为提供程序在cmdlet获取对象时应用筛选器，而不是让Powershell在访问对象后筛选对象。
-Include- 此cmdlet包括在操作中的项目被指定为字符串数组。 -Include参数的值限定-Path参数。 输入模式或路径元素，例如*.txt。 仅当cmdlet包含项目的内容(例如C:\*，通配符*用于指定C:目录的内容)时，-Include参数才有效。
-Exclude - 此cmdlet在操作中排除的项目指定为字符串数组。 -Exclude参数的值限定-Path参数。 输入模式或路径元素，例如*.txt。它接受通配符。 仅当cmdlet包含项目的内容(例如C:\*，通配符*用于指定C:目录的内容)时，-Exclude参数才有效。
-PassThru - 此参数返回一个对象，该对象表示正在使用的项目。 默认它不会产生任何输出。
-WhatIf - 此参数显示执行cmdlet将发生的情况。
-Confirm - 此参数在运行cmdlet之前提示确认。
-Value - 此参数用于指定要添加的内容。不能通过输入文件的路径来指定文件的内容，因为路径只是一个字符串。可以使用Get-content来获取内容并将其传递给-Value参数。
-Encoding - 此参数用于指定目标文件的编码类型。默认情况下，其值为UTF8NoBOM。 它是一个动态参数，FileSystem提供程序将其添加到Add-Content。 -Encoding参数仅在文件系统驱动器中起作用。以下是此参数可接受的值：ASCII,OEM,UTF8,UTF8BOM,UTF8NoBOM,Unicode,BigEndianUnicode,UTF32,UTF7。
-NoNewLine - 此参数指示此cmdlet不会向内容添加新行或回车。 在输出字符串之间不会插入任何换行符或空格，并且在最后一个输出字符串之后也不会添加任何换行符。
-Stream - 此参数用于为内容指定备用数据流。如果流不存在，它将创建它。参数接受通配符。它是一个动态参数，由FileSystem提供程序添加到Set-Content cmdlet。 它仅在文件系统的驱动器中起作用。

示例

示例1: 创建一个新文件并写入内容

PS E:\xntutor\powershell> set-content -path setcontent.txt -value "Windows Operating system"
PS E:\xntutor\powershell> get-content .\setcontent.txt
Windows Operating system

此示例中的第一个cmdlet创建一个新文件，并将字符串Windows Operating system写入该文件。 它使用-Path和-Value参数在当前目录中创建一个名为pw.txt的新文件。
在此示例中，第二个cmdlet使用Get-content cmdlet在PowerShell控制台中显示pw.txt文件的内容。

示例2： 替换目录中现有文件的内容。

PS E:\xntutor\powershell> set-content setcontent.txt -value "Hello, Powershell new script."
PS E:\xntutor\powershell> get-content .\setcontent.txt
Hello, Powershell new script.

在此示例中，替换当前目录中文件的内容。 此cmdlet使用-Value参数提供文本字符串Hello, Powershell new script.替换文件中的内容。

示例3： 创建一个新文件并将系统日期和时间写入文件

PS E:\xntutor\powershell> set-content date.txt -value (get-date)
PS E:\xntutor\powershell> get-content date.txt
2020/2/1 20:01:28

本示例中的第一个cmdlet创建一个新文件，并将系统的当前日期和时间写入当前目录中的文件。
Set-content cmdlet使用-Path和-Value参数在当前目录中创建一个名为date.txt的新文件。Get-date获取当前日期和时间。

在此示例中，第二个cmdlet使用Get-Content在PowerShell控制台中显示date.txt文件的内容。

上面几个示例的执行过程如下所示：