Get-Variable (Microsoft.PowerShell.Utility)

Get-Variable

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

句法

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

描述

Get-Variable cmdlet 获取当前控制台中的 PowerShell 变量。您可以通过指定 ValueOnly 参数来仅检索变量的值，并且可以按名称过滤返回的变量。

示例

示例1：按字母获取变量

此命令获取名称以字母 m 开头的变量。该命令还获取变量的值。

Get-Variable m*

示例2：按字母获取变量值

此命令仅获取名称以 m 开头的变量的值。

Get-Variable m* -ValueOnly

示例3：通过两个字母获取变量

此命令获取有关以字母 M 或字母 P 开头的变量的信息。

Get-Variable -Include M*,P*

示例 4：按范围获取变量

第一个命令仅获取在本地范围内定义的变量。它相当于Get-Variable -Scope Local，可以缩写为gv -s 0。

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

Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)

参数

-Exclude

指定此 cmdlet 从操作中排除的项目数组。允许使用通配符。

String[]

命名

None

False

False

True

-Include

指定 cmdlet 将对其执行操作的项目数组，不包括所有其他项目。允许使用通配符。

String[]

命名

None

False

False

True

-Name

指定变量的名称。允许使用通配符。您还可以通过管道将变量名称传递给 Get-Variable。

String[]

0

None

False

True

True

-Scope

指定范围内的变量。此参数可接受的值为：

• 全球
• 本地
• 脚本
• 相对于当前作用域的数字（0 到作用域数量，其中 0 是当前作用域，1 是其父作用域）

本地是默认值。有关详细信息，请参阅 about_Scopes。

String

命名

None

False

False

False

-ValueOnly

指示此 cmdlet 仅获取变量的值。

SwitchParameter

命名

None

False

False

False

输入

字符串

您可以通过管道将包含变量名称的字符串传递给此 cmdlet。

输出

PS变量

默认情况下，此 cmdlet 会为其获取的每个变量返回一个 AutomationPSVariable 对象。对象类型取决于变量。

对象[]

当您指定 ValueOnly 参数并且指定变量的值是集合时，此 cmdlet 将返回 [System.Object[]]。此行为会阻止正常的管道操作一次处理一个变量的值。强制进行集合枚举的解决方法是将 Get-Variable 命令括在括号中。

笔记

PowerShell 包含以下 Get-Variable 别名：

• 所有平台：

  gv