Get-Alias
Получает псевдонимы, действительные в ходе текущего сеанса.
Синтаксис
Get-Alias
[[-Name] <String[]>]
[-Exclude <String[]>]
[-Scope <String>]
[<CommonParameters>]
Get-Alias
[-Exclude <String[]>]
[-Scope <String>]
[-Definition <String[]>]
[<CommonParameters>]
Описание
Командлет Get-Alias получает псевдонимы в текущем сеансе. Сюда входят встроенные псевдонимы, заданные или импортированные псевдонимы, а также псевдонимы, добавленные в профиль PowerShell.
По умолчанию Get-Alias принимает псевдоним и возвращает имя команды. При использовании параметра Definitionget-Alias принимает имя команды и возвращает ее псевдонимы.
Начиная с Windows PowerShell 3.0, Get-Alias отображает имена псевдонимов без дефисов в <alias> -> <definition>
формате, что упрощает поиск необходимых сведений.
Примеры
Пример 1. Получение всех псевдонимов в текущем сеансе
PS C:\> Get-Alias
CommandType Name
----------- ----
Alias % -> ForEach-Object
Alias ? -> Where-Object
Alias ac -> Add-Content
Alias asnp -> Add-PSSnapin
Alias cat -> Get-Content
Alias cd -> Set-Location
Alias chdir -> Set-Location
Alias clc -> Clear-Content
Alias clear -> Clear-Host
Alias clhy -> Clear-History
...
Эта команда получает все псевдонимы в текущем сеансе.
В выходных данных показан формат, представленный <alias> -> <definition>
в Windows PowerShell 3.0.
Этот формат используется только для псевдонимов, не содержащих дефисы, поскольку вместо названий командлетов и функций предпочтительнее использовать псевдонимы с дефисами.
Пример 2. Получение псевдонимов по имени
Get-Alias -Name gp*, sp* -Exclude *ps
Эта команда получает все псевдонимы, начинающиеся с gp или sp, за исключением псевдонимов, заканчивающихся на ps.
Пример 3. Получение псевдонимов для командлета
Get-Alias -Definition Get-ChildItem
Эта команда получает псевдонимы для командлета Get-ChildItem.
По умолчанию командлет Get-Alias получает имя элемента, если вы знаете псевдоним. Параметр Definition получает псевдоним, когда известно имя элемента.
Пример 4. Получение псевдонимов по свойству
Get-Alias | Where-Object {$_.Options -Match "ReadOnly"}
Эта команда получает все псевдонимы, в которых свойство Options имеет значение ReadOnly. Эта команда позволяет быстро найти псевдонимы, встроенные в PowerShell, так как они имеют параметр ReadOnly.
Options — это только одно из свойств объектов AliasInfo, которые получает Get-Alias .
Чтобы найти все свойства и методы объектов AliasInfo, введите команду Get-Alias | get-member
.
Пример 5. Получение псевдонимов по имени и фильтрование по первой букве
Get-Alias -Definition "*-PSSession" -Exclude e* -Scope Global
Этот пример получает псевдонимы команд, имена которых заканчиваются на "-PSSession", кроме команд, начинающихся на букву "e".
Команда использует параметр Scope для применения команды в глобальном область. Эта функция пригодится в скриптах, где необходимо получить псевдонимы, действительные в сеансе.
Параметры
-Definition
Получает псевдонимы для заданного элемента. Введите имя командлета, функции, скрипта, файла или исполняемого файла.
Этот параметр называется Definition, так как он ищет имя элемента в свойстве Definition объекта псевдонима.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Exclude
Исключает указанные элементы. Значение этого параметра определяет значение параметров Name и Definition. Введите имя, определение или шаблон, например, "s *". Разрешено использовать подстановочные знаки.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Name
Задает получаемые этим командлетом псевдонимы.
Разрешено использовать подстановочные знаки.
По умолчанию извлекает все псевдонимы, Get-Alias
определенные для текущего сеанса.
Имя параметра Имя является необязательным.
Имена псевдонимов также можно передать в Get-Alias
.
Type: | String[] |
Position: | 0 |
Default value: | All aliases |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Scope
Задает область, псевдонимы для которой получает этот командлет. Допустимые значения для этого параметра:
- Глобальный
- Local
- Скрипт
- Номер относительно текущей области (от 0 до количества областей, где 0 — это текущая область, а 1 — ее родительская область).
По умолчанию используется значение Local. Дополнительные сведения см. в разделе about_Scopes.
Type: | String |
Position: | Named |
Default value: | Local |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Имена псевдонимов можно передать в Get-Alias.
Выходные данные
Get-Alias возвращает объект , представляющий каждый псевдоним. Get-Alias возвращает один и тот же объект для каждого псевдонима, но PowerShell использует формат на основе стрелок для отображения имен псевдонимов без дефисов.
Примечания
- Для создания нового псевдонима используйте командлет Set-Alias или New-Alias. Для удаления псевдонима используйте командлет Remove-Item.
- Формат имени псевдонима со стрелками не используется для псевдонимов, содержащих дефис. Для замены названий командлетов и функций такие псевдонимы более предпочтительны, чем обычные псевдонимы и сокращения.