Поделиться через

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-AliasDefinition принимает имя команды и возвращает ее псевдонимы.

Начиная с Windows PowerShell 3.0, отображаются имена псевдонимов без дефисов в формате<alias> -> <definition>, Get-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> -> <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

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