Compartilhar via

Get-Alias

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Obtém os aliases da sessão atual.

Sintaxe

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

Description

O cmdlet Get-Alias obtém os aliases na sessão atual. Isso inclui aliases internos, aliases que você definiu ou importou e aliases que você adicionou ao seu perfil do PowerShell.

Por padrão, Get-Alias usa um alias e retorna o nome do comando. Quando você usa o parâmetro definição de , usa um nome de comando e retorna seus aliases.

A partir do Windows PowerShell 3.0, Get-Alias exibe nomes de alias não hifenizados em um formato <alias> -> <definition> para facilitar ainda mais a localização das informações necessárias.

Exemplos

Exemplo 1: Obter todos os aliases na sessão atual

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
...

Esse comando obtém todos os aliases na sessão atual.

A saída mostra o formato <alias> -> <definition> introduzido no Windows PowerShell 3.0. Esse formato é usado apenas para aliases que não incluem hifens, pois aliases com hifens são normalmente nomes preferenciais para cmdlets e funções, em vez de apelidos.

Exemplo 2: Obter aliases por nome

Get-Alias -Name gp*, sp* -Exclude *ps

Esse comando obtém todos os aliases que começam com gp ou sp, exceto para aliases que terminam com ps.

Exemplo 3: Obter aliases para um cmdlet

Get-Alias -Definition Get-ChildItem

Esse comando obtém os aliases do cmdlet Get-ChildItem.

Por padrão, o cmdlet Get-Alias obtém o nome do item quando você conhece o alias. O parâmetro definição de obtém o alias quando você sabe o nome do item.

Exemplo 4: Obter aliases por propriedade

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

Esse comando obtém todos os aliases nos quais o valor da propriedade Options é ReadOnly. Esse comando fornece uma maneira rápida de localizar os aliases integrados ao PowerShell, pois eles têm a opção ReadOnly.

Options é apenas uma propriedade dos objetos AliasInfo que obtém. Para localizar todas as propriedades e métodos de objetos AliasInfo , digite .

Exemplo 5: Obter aliases por nome e filtro pela letra inicial

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

Este exemplo obtém aliases para comandos que têm nomes que terminam em "-PSSession", exceto aqueles que começam com "e".

O comando usa o parâmetro Scope para aplicar o comando no escopo global. Isso é útil em scripts quando você deseja obter os aliases na sessão.

Parâmetros

-Definition

Obtém os aliases do item especificado. Insira o nome de um cmdlet, função, script, arquivo ou arquivo executável.

Esse parâmetro é chamado Definição, pois pesquisa o nome do item na propriedade Definition do objeto alias.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-Exclude

Omite os itens especificados. O valor desse parâmetro qualifica os parâmetros de Nome e Definição. Insira um nome, uma definição ou um padrão, como "s*". Curingas são permitidos.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-Name

Especifica os aliases que esse cmdlet obtém. Curingas são permitidos. Por padrão, Get-Alias recupera todos os aliases definidos para a sessão atual. O nome do parâmetro Name é opcional. Você também pode canalizar nomes de alias para Get-Alias.

Tipo:String[]
Cargo:0
Valor padrão:All aliases
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-Scope

Especifica o escopo para o qual esse cmdlet obtém aliases. Os valores aceitáveis para este parâmetro são:

  • Global
  • Local
  • Script
  • Um número relativo ao escopo atual (0 por meio do número de escopos, em que 0 é o escopo atual e 1 é seu pai)

Local é o padrão. Para obter mais informações, consulte about_Scopes.

Tipo:String
Cargo:Named
Valor padrão:Local
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém um nome de alias para este cmdlet.

Saídas

AliasInfo

Esse cmdlet retorna um objeto que representa cada alias. Ele retorna o mesmo tipo de objeto para cada alias, mas o PowerShell usa um formato baseado em seta para exibir os nomes de aliases não hifenizados.

Observações

O PowerShell inclui os seguintes aliases para Get-Alias:

  • Todas as plataformas:

    • gal

  • Para criar um novo alias, use Set-Alias ou New-Alias. Para excluir um alias, use Remove-Item.

  • O formato de nome do alias baseado em seta não é usado para aliases que incluem um hífen. É provável que sejam nomes substitutos preferenciais para cmdlets e funções, em vez de abreviações ou apelidos típicos.