当前位置:网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] Clear-Item (Microsoft.PowerShell.Management)

作者:精品下载站 日期:2024-12-14 02:13:01 浏览:14 分类:玩电脑

Clear-Item (Microsoft.PowerShell.Management)


Clear-Item

模块 :Microsoft.PowerShell.Management

清除项目的内容,但不删除该项目。

句法

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

描述

Clear-Item cmdlet 可清除项目的内容,但不会删除该项目。例如,Clear-Item cmdlet 可以删除变量的值,但不会删除该变量。用于表示已清除项目的值由每个 PowerShell 提供程序定义。此 cmdlet 类似于 Clear-Content,但它适用于别名和变量,而不是文件。

示例

示例1:清除变量的值

此命令清除名为 TestVar1 的变量的值。该变量仍然有效,但其值设置为 $null。变量名称以 Variable: 为前缀,表示 PowerShell 变量提供程序。

备用命令显示,要获得相同的结果,您可以切换到 PowerShell Variable: 驱动器,然后运行 Clear-Item 命令。

Clear-Item Variable:TestVar1

Set-Location Variable:
PS Variable:\> Clear-Item TestVar1

示例 2:清除所有注册表项

此命令会清除“MyKey”子项中的所有注册表项,但前提是提示您确认您的意图。它不会删除“MyKey”子项或影响任何其他注册表项或条目。您可以使用包含排除参数来标识特定的注册表项,但不能使用它们来标识注册表项。

  • 要删除特定注册表项,请使用 Remove-ItemProperty cmdlet。
  • 要删除注册表项的值,请使用Clear-ItemProperty cmdlet
Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm

参数

-Confirm

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

类型 :

SwitchParameter

别名:

cf

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

-Credential

笔记

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

类型 :

PS凭证

位置:

命名

默认值:

当前用户

必需的:

False

接受管道输入:

True

接受通配符:

False

-Exclude

以字符串数组形式指定此 cmdlet 在操作中排除的一个或多个项目。此参数的值限定 Path 参数。输入路径元素或模式,例如 *.txt。允许使用通配符。仅当命令包含某个项目的内容时,排除参数才有效,例如C:\Windows\*,其中通配符指定的内容>C:\Windows 目录。

类型 :

String[]

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

True

-Filter

指定一个过滤器来限定 Path 参数。文件系统提供程序是唯一安装的支持使用过滤器的 PowerShell 提供程序。您可以在 about_Wildcards 中找到文件系统过滤器语言的语法。过滤器比其他参数更有效,因为提供程序在 cmdlet 获取对象时应用它们,而不是让 PowerShell 在检索对象后过滤对象。

类型 :

String

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

True

-Force

指示 cmdlet 清除无法更改的项目,例如只读别名。该 cmdlet 无法清除常量。实施方式因提供商而异。有关详细信息,请参阅 about_Providers。即使使用 Force 参数,cmdlet 也无法覆盖安全限制。

类型 :

SwitchParameter

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

-Include

以字符串数组形式指定此 cmdlet 在操作中包含的一个或多个项目。此参数的值限定 Path 参数。输入路径元素或模式,例如 "*.txt"。允许使用通配符。仅当命令包含某个项目的内容时,Include 参数才有效,例如 C:\Windows\*,其中通配符指定 的内容>C:\Windows 目录。

类型 :

String[]

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

True

-LiteralPath

指定到一个或多个位置的路径。 LiteralPath 的值完全按照键入的方式使用。没有字符被解释为通配符。如果路径包含转义字符,请将其用单引号引起来。单引号告诉 PowerShell 不要将任何字符解释为转义序列。

有关更多信息,请参阅 about_Quoting_Rules。

类型 :

String[]

别名:

PSPath, LP

位置:

命名

默认值:

None

必需的:

True

接受管道输入:

True

接受通配符:

False

-Path

指定正在清除的项目的路径。允许使用通配符。此参数是必需的,但参数名称 Path 是可选的。

类型 :

String[]

位置:

0

默认值:

None

必需的:

True

接受管道输入:

True

接受通配符:

True

-WhatIf

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

类型 :

SwitchParameter

别名:

wi

位置:

命名

默认值:

False

必需的:

False

接受管道输入:

False

接受通配符:

False

输入

字符串

您可以通过管道将路径字符串传递给此 cmdlet。

输出

此 cmdlet 不返回任何输出。

笔记

PowerShell 包含以下 Clear-Item 别名:

  • 所有平台:

      cli
  • Clear-Item cmdlet 仅受多个 PowerShell 提供程序支持,包括别名环境函数注册表变量提供商。因此,您可以使用 Clear-Item 删除提供程序命名空间中的项目内容。要列出会话中可用的提供程序,请输入 Get-PsProvider。有关详细信息,请参阅 about_Providers。

  • 您无法使用 Clear-Item 删除文件的内容,因为 PowerShell 文件系统提供程序不支持此 cmdlet。要清除文件,请使用Clear-Content

  • 您需要 登录账户 后才能发表评论

    取消回复欢迎 发表评论:

    关灯