Compartilhar via

Get-Alias

Módulo:
Microsoft.PowerShell.Utility Module

Obtém os aliases da sessão atual.

Sintaxe

Default (Padrão) 

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

Definition 

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

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

Definition
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-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*". Caracteres curinga são permitidos.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica os aliases que esse cmdlet obtém. Caracteres curinga 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.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:All aliases
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

Default
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-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 (variando de 0 até o número total de escopos, onde 0 é o escopo atual e 1 é o escopo pai)

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

Propriedades do parâmetro

Tipo:String
Valor padrão:Local
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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.