Clear-Variable

Clear-Variable
    [-Name] <String[]>
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Force]
    [-PassThru]
    [-Scope <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Clear-Variable cmdlet 删除存储在变量中的数据，但不会删除该变量。 因此，变量的值为 NULL（空）。 如果变量具有指定的数据或对象类型，则此 cmdlet 将保留存储在变量中的对象的类型。

Clear-Variable my* -Scope Global

此命令删除具有以 my 开头的名称的全局变量的值。

$a = 3
&{ Clear-Variable a }
$a

3

这些命令演示了清除子范围中的变量不会清除父范围中的值。 第一个命令将变量的值 $a 设置为 3。 第二个命令使用调用运算符（&）在新作用域中运行 Clear-Variable 命令。 变量在子作用域中被清除（即使它并不存在），但在本地作用域中没有被清除。 第三个命令获取 $a的值，表明值 3 不受影响。

Clear-Variable -Name "Processes"

此命令删除名为 Process 的变量的值。 cmdlet 完成操作后，名为 Process 的变量仍然存在，但值为 null。

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

不能用管道将对象传送到此 cmdlet。

默认情况下，此 cmdlet 不返回任何输出。

使用 PassThru 参数时，此 cmdlet 返回一个 PSVariable 对象，用于表示被清除的变量。

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

• 所有平台：

  • clv

• 若要删除变量及其值，请使用 Remove-Variable 或 Remove-Item。

  即使使用 Force 参数，此 cmdlet 也不会删除设置为常量或系统所拥有的变量的值。

  如果清除的变量不存在，则 cmdlet 不起作用。 它不会创建具有 null 值的变量。