获取当前控制台中的变量。

语法

Get-Variable [[-Name] <string[]>] [-Exclude <string[]>] [-Include <string[]>] [-Scope <string>] [-ValueOnly] [<CommonParameters>]

说明

Get-Variable cmdlet 获取当前控制台中的 Windows PowerShell 变量。通过指定 ValueOnly 参数可以只检索变量的值,还可以按名称筛选返回的变量。

参数

-Exclude <string[]>

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

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-Include <string[]>

指定 cmdlet 只对这些项执行操作,排除其他所有项。允许使用通配符。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-Name <string[]>

指定变量的名称。

是否为必需?

false

位置?

1

默认值

是否接受管道输入?

true (ByValue, ByPropertyName)

是否接受通配符?

false

-Scope <string>

仅获取指定作用域中的变量。有效值包括“Global”、“Local”、“Script”或者相对于当前作用域的数字(0 到作用域数,其中 0 是指当前作用域,1 是指其父作用域)。默认值为“Local”。有关详细信息,请参阅 about_Scopes。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-ValueOnly

只获取变量的值。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

<CommonParameters>

此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

输入

System.String

可以通过管道将包含变量名称的字符串传递给 Get-Variable。

输出

Variable object

Get-Variable 为它所获取的每个变量返回一个 System.Management.Automation 变量对象。对象类型取决于变量。

说明

此 cmdlet 不管理环境变量。若要管理环境变量,可以使用环境变量提供程序。

示例 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,先按名称排序,然后显示。






示例 4

C:\PS>get-variable -scope 0

C:\PS> compare-object (get-variable -scope 0) (get-variable -scope 1)

说明
-----------
第一个命令仅获取当前作用域中定义的变量。它等效于“get-variable -scope local”,可以缩写为“gv -s 0”。

第二个命令使用 Compare-Object cmdlet 来查找在父作用域 (Scope 1) 中定义的、但仅在当前作用域 (Scope 0) 中可见的变量。






另请参阅




目录