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

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 получает имя элемента при известном псевдониме. Параметр определения получает псевдоним, когда вы знаете имя элемента.

Пример 4. Получение псевдонимов по свойству

Get-Alias | Where-Object {$_.Options -match "ReadOnly"}

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

Параметры — это только одно свойство объектов AliasInfo, которые Get-Alias получает. Чтобы найти все свойства и метод ы объектов AliasInfo, введите Get-Alias | Get-Member.

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

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

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

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

Параметры

-Definition

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

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

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Exclude

Не удается указать указанные элементы. Значение этого параметра определяет параметры имени и определения. Введите имя, определение или шаблон, например "s*". Разрешены подстановочные знаки.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Name

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

Тип:String[]
Position:0
Default value:All aliases
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-Scope

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

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

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

Тип:String
Position:Named
Default value:Local
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

String

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

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

AliasInfo

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

Примечания

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

  • Все платформы:

    • gal

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

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