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 , Get-Alias 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

PS C:\> 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.

Opções é apenas uma propriedade dos objetos AliasInfo que Get-Alias obtém. Para localizar todas as propriedades e métodos de objetos AliasInfo, digite Get-Alias | get-member.

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 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
  • Roteiro
  • 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 nomes de alias para Get-Alias.

Saídas

AliasInfo

Get-Alias retorna um objeto que representa cada alias. Get-Alias retorna o mesmo objeto para cada alias, mas o PowerShell usa um formato baseado em seta para exibir os nomes de aliases não hifenizados.

Observações

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