Partilhar via

Get-Alias

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

Obtém os aliases para a 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 Definition, 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 de que você precisa.

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

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

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

Exemplo 2: Obter aliases por nome

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

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

Exemplo 3: Obter aliases para um cmdlet

Get-Alias -Definition Get-ChildItem

Este comando obtém os aliases para o cmdlet Get-ChildItem.

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

Exemplo 4: Obter aliases por propriedade

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

Este comando obtém todos os aliases nos quais o valor da propriedade Options é ReadOnly. Este comando fornece uma maneira rápida de localizar os aliases que são incorporados no PowerShell, porque eles têm a opção ReadOnly.

Options é 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 filtrar por 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 para o item especificado. Insira o nome de um cmdlet, função, script, arquivo ou arquivo executável.

Esse parâmetro é chamado de Definition, porque procura o nome do item na propriedade Definition do objeto alias.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-Exclude

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

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 Nome é opcional. Você também pode canalizar nomes de alias para Get-Alias.

Tipo:String[]
Position:0
Default value:All aliases
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-Scope

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

  • A nível mundial
  • Locais
  • Guião
  • Um número relativo ao escopo atual (0 através do número de escopos, onde 0 é o escopo atual e 1 é seu pai)

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

Tipo:String
Position:Named
Default value:Local
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Notas

  • Para criar um novo alias, use Set-Alias ou New-Alias. Para excluir um alias, use Remove-Item.
  • O formato de nome de alias baseado em seta não é usado para aliases que incluem um hífen. É provável que esses sejam nomes substitutos preferidos para cmdlets e funções, em vez de abreviaturas ou apelidos típicos.