Clear-Content

参考

模块:: Microsoft.PowerShell.Management

删除项的内容，但不删除该项。

语法

Clear-Content
     [-Path] <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-Stream <String>]
     [<CommonParameters>]

Clear-Content
     -LiteralPath <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [-Stream <String>]
     [<CommonParameters>]

Clear-Content
     [-Path] <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Clear-Content
     -LiteralPath <String[]>
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Force]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

说明

Clear-Content cmdlet 会删除项的内容，例如从文件中删除文本，但不会删除该项。因此，该项存在，但它为空。 Clear-Content 类似于 Clear-Item，但它适用于包含内容的项，而不是具有值的项。

示例

示例 1：从目录中删除所有内容

Clear-Content "..\SmpUsers\*\init.txt"

此命令从 SmpUsers 目录的所有子目录中 init.txt 文件中删除所有内容。文件不会被删除，但它们为空。

示例 2：使用通配符删除所有文件的内容

Clear-Content -Path "*" -Filter "*.log" -Force

此命令删除当前目录中具有 .log 文件扩展名的所有文件的内容，包括具有只读属性的文件。路径中的星号（*）表示当前目录中的所有项。 Force 参数使命令对只读文件有效。使用筛选器将命令限制为文件扩展名为 .log 的文件，而不是在路径中指定 *.log，从而使作更快。

示例 3：清除流中的所有数据

此示例演示 Clear-Content cmdlet 如何在使流保持不变时从备用数据流中清除内容。

第一个命令使用 Get-Content cmdlet 获取从 Internet 下载的 Copy-Script.ps1 文件中 Zone.Identifier 流的内容。

第二个命令使用 Clear-Content cmdlet 清除内容。

第三个命令重复第一个命令。它会验证内容是否已清除，但流仍保留。如果删除了流，该命令将生成错误。

可以使用如下所示的方法清除备用数据流的内容。但是，不建议使用安全检查来阻止从 Internet 下载的文件。如果验证下载的文件是否安全，请使用 Unblock-File cmdlet。

Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

[ZoneTransfer]
ZoneId=3

Clear-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier
Get-Content C:\Test\Copy-Script.ps1 -Stream Zone.Identifier

参数

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Credential

注意

任何随 PowerShell 一起安装的提供程序都不支持此参数。若要模拟其他用户，或在运行此 cmdlet 时提升凭据，请使用 Invoke-Command。

类型:	PSCredential
Position:	Named
默认值:	Current user
必需:	False
接受管道输入:	True
接受通配符:	False

-Exclude

指定此 cmdlet 从内容的路径中省略的字符串作为字符串数组。此参数的值限定 Path 参数。输入路径元素或模式，例如 *.txt。允许通配符。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-Filter

以提供程序的格式或语言指定筛选器。此参数的值限定 Path 参数。筛选器的语法（包括通配符的使用）取决于提供程序。筛选器比其他参数更有效，因为提供程序在检索对象时应用它们，而不是在检索对象后让 PowerShell 筛选对象。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-Force

强制命令运行而不要求用户确认。

类型:	SwitchParameter
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Include

指定此 cmdlet 清除的内容作为字符串数组。此参数的值限定 Path 参数。输入路径元素或模式，例如 *.txt。允许通配符。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	True

-LiteralPath

指定从中删除内容的项目的路径。与 Path 参数不同，LiteralPath 的值与键入时完全相同。不会将任何字符解释为通配符。如果路径包含转义字符，请将它括在单引号（'）。单引号指示让 PowerShell 不将任何字符解释为转义序列。

类型:	String[]
别名:	PSPath, LP
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Path

指定从中删除内容的项目的路径。允许通配符。路径必须是项的路径，而不是容器的路径。例如，必须指定一个或多个文件的路径，而不是目录的路径。允许通配符。此参数是必需的，但参数名称（Path）是可选的。

类型:	String[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	True

-Stream

这是 FileSystem 提供程序提供的动态参数。此参数仅在 Windows 上可用。

指定内容的替代数据流。如果该流不存在，则此 cmdlet 会创建它。不支持通配符。

可以使用 Clear-Content cmdlet 更改任何备用数据流的内容，例如 Zone.Identifier。但是，我们不建议这样做，以消除阻止从 Internet 下载的文件的安全检查。如果验证下载的文件是否安全，请使用 Unblock-File cmdlet。

此参数是在 PowerShell 3.0 中引入的。从 PowerShell 7.2 起，Clear-Content 可以从目录和文件清除备用数据流的内容。

有关详细信息，请参阅 about_FileSystem_Provider。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

None

不能通过管道将对象传递给此 cmdlet。

输出