Remove-Variable

项目
10/30/2009

删除变量及其值。

语法

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。

输出

无

此 cmdlet 不返回任何输出。

说明

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

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

示例 1

C:\PS>remove-variable Smp

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

另请参阅

概念

Set-Variable
Get-Variable
Clear-Variable
New-Variable
about_Profiles

通过