Remove-Variable 帮助信息

 

如下说明是翻译: help Remove-Variable 产生的帮助信息.

译者: Edengundam(马涛)

 

Remove-Variable

 

大纲

删除变量和该变量的值.

 

语法

Remove-Variable [-name] <string[]> [-include <string[]>] [-exclude <string[]>] [-scope <string>] [-force] [-whatIf] [-confirm] [<CommonParameters>]

 

详细描述

Remove-Variable cmdlet从变量定义的作用域(例如: 当前作用域)删除该变量及其值. 你不能使用此cmdlet删除那些设置为常量的变量或系统变量. 除非你使用Export-Console来保存当前控制台的设置, 否则所有变化只对当前控制台有影响.

 

参数

 

-name <string[]>

指定要删除的变量名称. 参数名称("-Name")可以不出现.

 

强制参数?	true
参数位置?	1
默认值	N/A - 必须指定名称
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	true

 

-include <string[]>

只删除指定的项目. 此参数值用于限定Name参数. 输入一个路径元素或模式, 例如"s*"(此参数允许通配符).

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	true

 

-exclude <string[]>

忽略指定的项目. 此参数值用于限定Name参数. 输入一个路径元素或模式, 例如"s*"(此参数允许通配符).

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	true

 

-scope <string>

指定该变量的生存作用域(译者注: 原文此处使用了单词export, 在其他的shell中, 一般父进程通过export将变量传递给子进程. ). 此值可以是命名作用域: "global", "local"或"script", 也可以是一个相对当前作用于的值(此值范围是从0到当前活动的作用域数量. 0代表当前作用域, 1代表父作用域). 默认值为"Local". 更多信息, 请输入"get-help about_scope".

 

强制参数?	false
参数位置?	named
默认值	Local
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-force <SwitchParameter>

在不破坏安全前提下, 能够避免影响命令成功执行的限制条件. 例如: Force参数能够覆盖具有只读属性的文件或创建路径中的必要成分, 但是不会改变人和文件的权限.

 

强制参数?	false
参数位置?	named
默认值	False
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-whatIf

描述执行此命令将会发生的现象, 不会真正执行此命令.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-confirm

执行命令前提示你进行确认.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

<公共参数>

此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".

 

输入类型

Object

 

返回类型

none

 

注意

 

更多信息, 输入"Get-Help Remove-Variable -detailed".需要技术信息, 输入"Get-Help Remove-Variable -full".

 

 如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".

 

你可以使用RemoveVariable内建别名"rv".需要更多信息, 查看About_Alias.

 

例1

 

C:/PS>remove-variable Smp

 

删除已经存在的变量$Smp

 

相关链接

Set-Variable

Get-Variable

Clear-Variable

New-Variable