Remove-Variable
删除变量及其值。
语法
Default （默认值）
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 |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Exclude
指定此 cmdlet 从操作中省略的项数组。 此参数的值用于限定 Name 参数。 输入名称元素或模式，例如“s*”。 允许使用通配符。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Force
指示即使该变量为只读，该 cmdlet 也会删除变量。 即使使用 Force 参数，cmdlet 也无法删除常量。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Include
指定此 cmdlet 在操作中删除的项数组。 此参数的值用于限定 Name 参数。 输入名称元素或模式，例如 s*。 允许使用通配符。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
指定要删除的变量的名称。 参数名称（Name） 是可选的。 允许通配符
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | True |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Scope
仅获取指定作用域中的变量。 此参数的可接受值为：
- 全球
- 本地
- 剧本
- 相对于当前范围的数字（0 到范围的数目，其中 0 是当前范围，1 是它的父范围）
本地为默认值。 有关详细信息，请参阅 about_Scopes。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
PSVariable
您可以将变量对象通过管道传输到 Remove-Variable。
输出
None
此 cmdlet 不返回任何输出。
备注
更改仅影响当前范围，例如会话。 若要从所有会话中删除变量，请将
Remove-Variable命令添加到 PowerShell 配置文件。还可以通过其内置别名
Remove-Variable来引用rv。 有关详细信息，请参阅 about_Aliases。