Partilhar via

Get-Alias

Módulo:
Microsoft.PowerShell.Utility Module

Obtém os aliases para a sessão atual.

Sintaxe

Default (Predefiniçã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 Definition, Get-Alias usa um nome de comando e retorna seus aliases.

A partir do Windows PowerShell 3.0, o 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

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 Opções é 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 do AliasInfo objetos 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.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

Definition
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

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

Propriedades dos parâmetros

Tipo:

String[]

Default value:All aliases
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

Default
Position:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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 (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.

Propriedades dos parâmetros

Tipo:String
Default value:Local
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 contendo um nome de alias para esse cmdlet.

Saídas

AliasInfo

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

Notas

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