Возвращает псевдонимы, действительные в ходе текущего сеанса.
Синтаксис
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 команды. Это бывает полезно в скриптах, в которых требуется получить псевдонимы в сеансе.
См. также