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

Get-Alias

Модуль:
Microsoft.PowerShell.Utility Module

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

Синтаксис

Default (по умолчанию) 

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

Definition 

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[]

Default value:None
Поддерживаются подстановочные знаки:True
DontShow:False

Наборы параметров

Definition
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Exclude

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:True
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

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

Свойства параметра

Тип:

String[]

Default value:All aliases
Поддерживаются подстановочные знаки:True
DontShow:False

Наборы параметров

Default
Position:0
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Scope

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

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

Local — это значение по умолчанию. Для получения дополнительной информации см. about_Scopes.

Свойства параметра

Тип:String
Default value:Local
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

String

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

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

AliasInfo

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

Примечания

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

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

    • gal

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

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