Remove-Variable

参考

模块:: Microsoft.PowerShell.Utility

删除变量及其值。

语法

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

说明

Remove-Variable cmdlet 从定义变量的范围中删除变量及其值，例如当前会话。不能使用此 cmdlet 删除设置为常量或系统拥有的变量。

示例

示例 1：删除变量

Remove-Variable Smp

此命令将删除 $Smp 变量。

参数

-Confirm

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

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

-Exclude

指定此 cmdlet 从操作中省略的项数组。此参数的值限定 Name 参数。输入名称元素或模式，例如“s*”。允许通配符。

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

-Force

指示即使该变量为只读，该 cmdlet 也会删除变量。即使使用 Force 参数，cmdlet 也无法删除常量。

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

-Include

指定此 cmdlet 在操作中删除的项数组。此参数的值限定 Name 参数。输入名称元素或模式，例如 s*。允许通配符。

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

-Name

指定要删除的变量的名称。参数名称（Name）是可选的。允许通配符

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

-Scope

仅获取指定作用域中的变量。此参数的可接受值为：

全球
当地
脚本
相对于当前范围的数字（0 到范围的数目，其中 0 是当前范围，1 是它的父范围）

本地为默认值。有关详细信息，请参阅 about_Scopes。

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

-WhatIf

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

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

输入

PSVariable

可以通过管道将变量对象传递给 Remove-Variable。

输出

None

此 cmdlet 不返回任何输出。

备注

更改仅影响当前范围，例如会话。若要从所有会话中删除变量，请将 Remove-Variable 命令添加到 PowerShell 配置文件。
还可以通过其内置别名 rv来引用 Remove-Variable。有关详细信息，请参阅 about_Aliases。

通过