Возвращает псевдонимы, действительные в ходе текущего сеанса.

Синтаксис

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

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

Описание

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

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

Параметры

-Definition <string[]>

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

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

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

true

-Exclude <string[]>

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

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Name <string[]>

Задает псевдонимы, которые нужно получить. Подстановочные знаки разрешены. По умолчанию командлет Get-Alias возвращает все псевдонимы, определенные для текущего сеанса. Имя параметра ("Name") указывать необязательно. Кроме того, можно передать имена псевдонимов в Get-Alias с помощью конвейера.

Обязательно?

false

Позиция?

1

Значение по умолчанию

Принимать входные данные из конвейера?

true (ByValue, ByPropertyName)

Принимать подстановочные знаки?

false

-Scope <string>

Получает только псевдонимы в заданной области. Допустимые значения: "Global", "Local", "Script" или номер относительно текущей области (от 0 до количества областей, где 0 — текущая область, а 1 — ее родительская область). По умолчанию используется значение "Local". Дополнительные сведения см. в разделе about_Scopes.

Обязательно?

false

Позиция?

named

Значение по умолчанию

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

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

System.String

Можно передать имена псевдонимов в Get-Alias с помощью конвейера.

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

System.Management.Automation.AliasInfo

Командлет Get-Alias возвращает объект, представляющий каждый из псевдонимов.

Примечания

Псевдоним — это альтернативное имя командлета, функции или исполняемого файла. Для выполнения командлета, функции или исполняемого файла можно использовать как его полное имя, так и любой его псевдоним. Дополнительные сведения см. в разделе About_Aliases.

Для создания нового псевдонима используйте командлет Set-Alias или New-Alias. Для удаления псевдонима используйте командлет Remove-Item.

Пример 1

C:\PS>get-alias

Описание
-----------
Эта команда получает все псевдонимы в текущем сеансе.






Пример 2

C:\PS>get-alias -name g*, s* -exclude get-*

Описание
-----------
Эта команда получает все псевдонимы, имена которых начинаются на "g" или "s", кроме псевдонимов, начинающихся на "get-".






Пример 3

C:\PS>get-alias -definition Get-ChildItem

Описание
-----------
Эта команда получает псевдонимы для командлета Get-ChildItem.

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






Пример 4

C:\PS>get-alias | where-object {$_.Options -match "ReadOnly"}

Описание
-----------
Эта команда возвращает все псевдонимы, в которых свойство Options имеет значение ReadOnly. Она позволяет быстро найти псевдонимы, встроенные в Windows PowerShell, потому что они имеют параметр ReadOnly.

Options — это только одно из свойств объектов AliasInfo, получаемых командлетом Get-Alias. Чтобы найти все свойства и методы объектов AliasInfo, введите команду "get-alias | get-member".






Пример 5

C:\PS>get-alias -definition "*-pssession" -exclude e* -scope global

Описание
-----------
Этот пример получает псевдонимы команд, имена которых заканчиваются на "-pssession", кроме команд, начинающихся на "e". 

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






См. также