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 принимает псевдоним и возвращает имя команды. При использовании параметра Get-Alias Определения принимает имя команды и возвращает его псевдонимы.

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

Примеры

Пример 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> -> <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 .

Параметры — это только одно свойство объектов 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 определенные для текущего сеанса. Имя параметра Name указывать необязательно. Вы также можете передать имена Get-Aliasпсевдонимов в .

Type:String[]
Position:0
Default value:All aliases
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Scope

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

  • Global
  • Local
  • Script
  • Номер относительно текущей области (от 0 до количества областей, где 0 — это текущая область, а 1 — ее родительская область).

Значение по умолчанию — Local. Дополнительные сведения см. в about_Scopes.

Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

String

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

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

AliasInfo

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

Примечания

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

  • Для всех платформ.

    • gal

  • Чтобы создать новый псевдоним, используйте Set-Alias или New-Alias. Чтобы удалить псевдоним, используйте Remove-Item.

  • Формат имени псевдонима со стрелками не используется для псевдонимов, содержащих дефис. Для замены названий командлетов и функций такие псевдонимы более предпочтительны, чем обычные псевдонимы и сокращения.