Remove-Variable (Microsoft.PowerShell.Utility)
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
- 位置：
命名
- 默认值：
False
- 必需的：
False
- 接受管道输入：
False
- 接受通配符：
False
-Exclude
指定此 cmdlet 从操作中省略的项目数组。此参数的值限定 Name 参数。输入名称元素或模式，例如“s*”。允许使用通配符。
- 类型 ：
String[]
- 位置：
命名
- 默认值：
None
- 必需的：
-
False
- 接受管道输入：
False
- 接受通配符：
True
-Force
指示 cmdlet 删除变量，即使该变量是只读的。即使使用 Force 参数，cmdlet 也无法删除常量。
- 类型 ：
SwitchParameter
- 位置：
命名
- 默认值：
None
- 必需的：
False
- 接受管道输入：
False
- 接受通配符：
False
-Include
指定此 cmdlet 在操作中删除的项目数组。此参数的值限定 Name 参数。输入名称元素或模式，例如 s*。允许使用通配符。
- 类型 ：
String[]
- 位置：
命名
- 默认值：
None
- 必需的：
False
- 接受管道输入：
False
- 接受通配符：
True
-Name
指定要删除的变量的名称。参数名称 (Name) 是可选的。允许使用通配符
- 类型 ：
String[]
- 位置：
0
- 默认值：
None
- 必需的：
True
- 接受管道输入：
True
- 接受通配符：
True
-Scope
只获取指定范围内的变量。该参数可接受的值为：
- 全球的
- 当地的
- 脚本
- 相对于当前作用域的数字（0 到作用域数量，其中 0 是当前作用域，1 是其父作用域）
本地是默认值。有关详细信息，请参阅 about_Scopes。
- 类型 ：
String
- 位置：
命名
- 默认值：
None
- 必需的：
False
- 接受管道输入：
False
- 接受通配符：
False
-WhatIf
显示 cmdlet 运行时会发生什么情况。该 cmdlet 未运行。
- 类型 ：
SwitchParameter
- 别名：
wi
- 位置：
命名
- 默认值：
False
- 必需的：
False
- 接受管道输入：
False
- 接受通配符：
False
输入
PS变量
您可以通过管道将变量对象传递给此 cmdlet。
输出
无
此 cmdlet 不返回任何输出。
笔记
PowerShell 包含以下 Remove-Variable 别名：
所有平台：
rv
更改仅影响当前范围，例如会话。要从所有会话中删除变量，请将 Remove-Variable 命令添加到您的 PowerShell 配置文件中。