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

Синтаксис

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

Описание

Командлет Get-Variable получает переменные Windows PowerShell, определенные для текущей консоли. Можно извлечь только значения переменных, указав параметр ValueOnly, а также отфильтровать возвращенные переменные по имени.

Параметры

-Exclude <string[]>

Исключает указанные элементы. Подстановочные знаки разрешены.

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Include <string[]>

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

Обязательно?	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>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

Входные данные

System.String

Строку, содержащую имя переменной, можно передать по конвейеру командлету Get-Variable.

Выходные данные

Variable object

Командлет Get-Variable возвращает объект переменной System.Management.Automation для каждой получаемой им переменной. Тип объекта зависит от переменной.

Примечания

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

Пример 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, сортируются по имени и отображаются.

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

Get-Variable