Obtém os aliases da sessão atual.

Sintaxe

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

Get-Alias [-Definition <string[]>] [-Exclude <string[]>] [-Scope <string>] [<CommonParameters>]

Descrição

O cmdlet Get-Alias obtém os alias (nomes alternativos para comandos e arquivos executáveis) na sessão atual. Isso inclui aliases internos, aliases definidos ou importados por você e aliases adicionados ao seu perfil do Windows PowerShell.

Por padrão, Get-Alias usa um alias e retorna o nome do comando. Ao usar o parâmetro Definition, o Get-Alias usa um nome de comando e retorna seus alias.

Parâmetros

-Definition <string[]>

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

Esse parâmetro é chamado Definition por que pesquisa o nome do item na propriedade Definition do objeto de alias.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

true

-Exclude <string[]>

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

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Name <string[]>

Especifica os aliases a serem recuperados. Os caracteres curinga são permitidos. Por padrão, o Get-Alias recupera todos os alias definidos para a sessão atual. O nome do parâmetro ("Name") é opcional. Também é possível canalizar nomes de alias para o Get-Alias.

Necessário?

false

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

-Scope <string>

Obtém apenas os alias no escopo especificado. Os valores válidos são "Global", "Local" ou "Script" ou um número relativo ao atual escopo (0 ao 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.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.String

É possível canalizar nomes de alias para o Get-Alias.

Saídas

System.Management.Automation.AliasInfo

Get-Alias retorna um objeto que representa cada alias.

Observações

Um alias é um nome alternativo ou apelido para um cmdlet, função ou arquivo executável. Para executar o cmdlet, a função ou o executável, você pode usar seu nome completo ou qualquer alias. Para obter mais informações, consulte about_Aliases.

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

Exemplo 1

C:\PS>get-alias

Descrição
-----------
Esse comando obtém todos os alias da sessão atual.






Exemplo 2

C:\PS>get-alias -name g*, s* -exclude get-*

Descrição
-----------
Esse comando obtém todos os alias que começam com "g" ou "s", com exceção de aliases que começam com "get-."






Exemplo 3

C:\PS>get-alias -definition Get-ChildItem

Descrição
-----------
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 Definition obtém o alias quando você conhece o nome do item.






Exemplo 4

C:\PS>get-alias | where-object {$_.Options -match "ReadOnly"}

Descrição
-----------
Este comando recupera todos os aliases nos quais o valor da propriedade Options seja ReadOnly. Este comando fornece um método rápido para localizar os aliases internos do Windows PowerShell, pois eles possuem a opção ReadOnly.

Options é apenas uma propriedade dos objetos de AliasInfo recuperadas pelo Get-Alias. Para localizar todas as propriedades e métodos dos objetos do AliasInfo, digite "get-alias | get-member".






Exemplo 5

C:\PS>get-alias -definition "*-pssession" -exclude e* -scope global

Descrição
-----------
Esse exemplo obtém aliases de comandos que têm nomes que terminam em "-pssession", com exceção daqueles 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 alias da sessão.






See Also




Sumário