Clear-Item

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，但它适用于别名和变量，而不是文件。

此命令清除名为 TestVar1的变量的值。 变量保持不变且有效，但其值设置为 $null。 变量名称以 Variable: 为前缀，以指示 PowerShell 变量提供程序。

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

Clear-Item Variable:TestVar1

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

此命令清除“MyKey”子项中的所有注册表项，但仅在提示你确认意图之后。 它不会删除“MyKey”子项或影响任何其他注册表项或条目。 可以使用 包括 和 排除 参数来标识特定的注册表键，但不能使用它们来标识注册表项。

• 若要删除特定注册表项，请使用 Remove-ItemProperty cmdlet。
• 若要删除注册表项的值，请使用 Clear-ItemProperty cmdlet。

Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm

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

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

此 cmdlet 不返回任何输出。

PowerShell 包含以下与 Clear-Item相关的别名：

• 所有平台：

  • cli

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

• 不能使用 Clear-Item 删除文件的内容，因为 PowerShell FileSystem 提供程序不支持此 cmdlet。 若要清除文件，请使用 Clear-Content。