Get-Variable
Возвращает переменные в текущей консоли.
Синтаксис
Default (по умолчанию)
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[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Include
Указывает массив элементов, с которым будет действовать командлет, за исключением всех остальных. Подстановочные символы разрешены.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имя переменной.
Подстановочные символы разрешены.
Можно также передать имя переменной в Get-Variable.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Scope
Указывает переменные в области. Допустимые значения для этого параметра:
- Global
- Локальная среда
- Скрипт
- Число относительно текущей области (от 0 до числа областей, где 0 является текущей областью, а 1 — родительским)
локальный используется по умолчанию. Для получения дополнительной информации см. about_Scopes.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ValueOnly
Указывает, что этот командлет получает только значение переменной.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
String
Можно передать строку, содержащую имя переменной в этот командлет.
Выходные данные
PSVariable
По умолчанию этот командлет возвращает объект AutomationPSVariable для каждой переменной, которую он получает. Тип объекта зависит от переменной.
Object
При указании параметра ValueOnly и значения указанной переменной является коллекцией, этот командлет возвращает [System.Object[]]. Это поведение предотвращает обработку значений переменной в течение одного раза в обычной операции конвейера. Решение для принудительного перечисления коллекций заключается в том, чтобы заключить команду Get-Variable в скобки.
Примечания
PowerShell включает следующие псевдонимы для Get-Variable:
Все платформы:
gv
Этот командлет не управляет переменными среды. Для управления переменными среды можно использовать поставщик среды.
