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