Get-Alias (Microsoft.PowerShell.Utility)

Get-Alias

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

Получает псевдонимы для текущего сеанса.

Синтаксис

Get-Alias
   [[-Name] <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]

Get-Alias
   [-Exclude <String[]>]
   [-Scope <String>]
   [-Definition <String[]>]
   [<CommonParameters>]

Описание

Командлет Get-Alias получает псевдонимы в текущем сеансе. Сюда входят встроенные псевдонимы, псевдонимы, которые вы установили или импортировали, а также псевдонимы, которые вы добавили в свой профиль PowerShell.

По умолчанию Get-Alias принимает псевдоним и возвращает имя команды. Когда вы используете параметр Definition, Get-Alias принимает имя команды и возвращает ее псевдонимы.

Начиная с Windows PowerShell 3.0, Get-Alias отображает имена псевдонимов без дефиса в формате <alias> -> , что еще больше упрощает поиск нужной информации. вам нужно.

`Примеры`

`Пример 1. Получение всех псевдонимов в текущем сеансе.`

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> -> , представленный в 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 | получить-член.

`Пример 5. Получение псевдонимов по имени и фильтрация по начальной букве`

Get-Alias -Definition "*-PSSession" -Exclude e* -Scope Global

В этом примере получаются псевдонимы для команд, имена которых заканчиваются на «-PSSession», за исключением тех, которые начинаются с «e».

Команда использует параметр Scope, чтобы применить команду в глобальной области. Это полезно в сценариях, когда вы хотите получить псевдонимы в сеансе.

`Параметры`

`-Definition`

Получает псевдонимы для указанного элемента. Введите имя командлета, функции, сценария, файла или исполняемого файла.

Этот параметр называется Definition, поскольку он ищет имя элемента в свойстве Definition объекта-псевдонима.

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

`-Exclude`

Пропускает указанные элементы. Значение этого параметра определяет параметры Имя и Определение. Введите имя, определение или шаблон, например «s*». Подстановочные знаки разрешены.

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

`-Name`

Указывает псевдонимы, которые получает этот командлет. Подстановочные знаки разрешены. По умолчанию Get-Alias извлекает все псевдонимы, определенные для текущего сеанса. Имя параметра Name не является обязательным. Вы также можете передать имена псевдонимов в Get-Alias.

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

`-Scope`

Указывает область, для которой этот командлет получает псевдонимы. Допустимые значения этого параметра:

Global

Local

Script

Число относительно текущей области (от 0 до количества областей, где 0 — текущая область, а 1 — ее родительский).

Локальный — значение по умолчанию. Дополнительные сведения см. в разделе about_Scopes.

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

`Входы`

Строка

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

`Выходы`

Информация об псевдониме

Этот командлет возвращает объект, представляющий каждый псевдоним. Он возвращает объект одного и того же типа для каждого псевдонима, но PowerShell использует формат на основе стрелок для отображения имен псевдонимов без дефиса.

`Примечания`

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

Все платформы:
Чтобы создать новый псевдоним, используйте Set-Alias или New-Alias. Чтобы удалить псевдоним, используйте Remove-Item.
Формат имени псевдонима на основе стрелок не используется для псевдонимов, содержащих дефис. Скорее всего, это будут предпочтительные имена-заменители командлетов и функций вместо типичных сокращений или псевдонимов.