Get-Variable (Microsoft.PowerShell.Utility)

Get-Variable

Модуль:: Microsoft.PowerShell.Utility

Получает переменные в текущей консоли.

Синтаксис

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

Описание

Командлет Get-Variable получает переменные 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 для поиска переменных, которые определены в родительской области (область 1), но видимы только в локальной области (область 0).

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

Параметры

-Exclude

Указывает массив элементов, которые этот командлет исключает из операции. Подстановочные знаки разрешены.

Тип :: String[]
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: True

-Include

Указывает массив элементов, над которыми будет действовать командлет, исключая все остальные. Подстановочные знаки разрешены.

Тип :: 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

Указывает, что этот командлет получает только значение переменной.

Тип :: SwitchParameter
Позиция:: Именованный
Значение по умолчанию:: None
Необходимый:: False
Примите ввод конвейера:: False
Принимайте подстановочные знаки:: False

Входы

Строка

В этот командлет можно передать строку, содержащую имя переменной.

Выходы

PSVariable

По умолчанию этот командлет возвращает объект AutomationPSVariable для каждой полученной переменной. Тип объекта зависит от переменной.

Объект[]

Если вы укажете параметр ValueOnly и значение указанной переменной является коллекцией, этот командлет возвращает [System.Object[]]. Такое поведение не позволяет нормальной работе конвейера обрабатывать значения переменной по одному. Обходной путь принудительного перечисления коллекции — заключить команду Get-Variable в круглые скобки.

Примечания

PowerShell включает следующие псевдонимы для Get-Variable:

Все платформы:
Этот командлет не управляет переменными среды. Для управления переменными среды вы можете использовать поставщика переменных среды.