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