Get-Variable 帮助信息

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

译者 : Edengundam( 马涛 )

 

Get-Variable

 

大纲

获取当前控制台的变量 .

 

语法

Get-Variable [[-name] <string[]>] [-include <string[]>] [-exclude <string[]>] [-valueOnly] [-scope <string>] [<CommonParameters>]

 

详细描述

获取当前控制台的 Windows PowerShell 变量 . 通过指定参数 ValueOnly 你可以只返回变量的值 ,    也可以根据变量名称对返回结果进行过滤 .

 

参数

 

-name <string[]>

指定变量的名称 .

 

强制参数 ?	false
参数位置 ?	1
默认值	* ( 取得 Variable:/ 下的所有变量 )
允许从管道绑定输入 ?	true ( 根据值 , 根据属性名 )
允许通配符扩展 ?	true

 

-include <string[]>

指定只由此 cmdlet 操作的对象 , 排除所有其它对象 . 允许使用通配符 .

 

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

 

-exclude <string[]>

忽略指定项 . 允许使用通配符 .

 

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

 

-valueOnly <SwitchParameter>

只返回变量的值 .

 

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

 

-scope <string>

限制检索指定作用域的变量 ( 译者注 : 原文此处使用了单词 export, 在其他的 shell 中 , 一般父进程通过 export 将变量传递给子进程 . ). 此值可以是命名作用域 : "global", "local" 或 "script", 也可以是一个相对当前作用于的值 ( 此值范围是从 0 到当前活动的作用域数量 . 0 代表当前作用域 , 1 代表父作用域 ).

 

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

 

< 公共参数 >

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

 

输入类型

Object

 

返回类型

Object

 

注意

 

此命令不能管理环境变量 . 管理环境变量 , 可以使用环境变量提供程序 .

 

例 1

 

C:/PS>get-variable m*

 

此命令显示名称以 'm' 开头的变量 . 变量的名称 , 变量的值都会被显示 .

 

例 2

 

C:/PS>get-variable m* -valueonly

 

此命令只显示名称以 'm' 开头的变量值 .

 

例 3

 

C:/PS>get-variable -include M*,P* | sort-object name

 

此命令取得名称以 'M' 或 'P' 开头的变量的信息 . 结果通过管道发送给 Sort-Object cmdlet, 后者根据名称进行排序并显示排序后结果 .

 

相关链接

Set-Variable

New-Variable

Clear-Variable

Remove-Variable