Получает переменные, определенные для текущей консоли.
Синтаксис
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).
См. также