删除变量及其值。

语法

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

说明

Remove-Variable cmdlet 从定义变量的作用域(例如,当前会话)中删除变量及其值。不能使用此 cmdlet 删除被设置为常量的变量或那些被系统拥有的变量。

参数

-Exclude <string[]>

忽略指定项。此参数的值对 Name 参数进行限定。请输入名称元素或模式,例如“s*”。允许使用通配符。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-Force

允许该 cmdlet 删除变量(即使该变量是只读的)。即使使用 Force 参数,该 cmdlet 也无法删除常量。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-Include <string[]>

只删除指定项。此参数的值对 Name 参数进行限定。请输入名称元素或模式,例如“s*”。允许使用通配符。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-Name <string[]>

指定要删除的变量的名称。参数名(“Name”)为可选项。

是否为必需?

true

位置?

1

默认值

是否接受管道输入?

true (ByPropertyName)

是否接受通配符?

false

-Scope <string>

指定此别名的有效作用域。有效值包括“Global”、“Local”、“Script”或者相对于当前作用域的数字(0 到作用域数,其中 0 是指当前作用域,1 是指其父作用域)。默认值为“Local”。有关详细信息,请参阅 about_Scopes。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-Confirm

在执行命令之前提示您进行确认。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-WhatIf

描述如果执行该命令会发生什么情况(无需实际执行该命令)。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

<CommonParameters>

此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

输入

System.Management.Automation.PSVariable

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

输出

None

此 cmdlet 不返回任何输出。

说明

所做更改只影响当前作用域,如会话。要将一个变量从所有会话中删除,请在 Windows PowerShell 配置文件中添加 Remove-Variable 命令。

还可以使用其内置别名“rv”引用 RemoveVariable。有关详细信息,请参阅 about_Aliases。

示例 1

C:\PS>remove-variable Smp

说明
-----------
此命令删除 $Smp 变量。






另请参阅




目录