about_Aliases
Descrição breve
Descreve como usar nomes alternativos para cmdlets e comandos no PowerShell.
Descrição longa
An alias é um nome ou apelido alternativo para um cmdlet ou para um elemento de comando, como uma função, script, arquivo ou arquivo executável. Você pode usar o alias nome do comando instead of the em qualquer comando do PowerShell.
Para criar um alias, use o New-Alias
cmdlet. Por exemplo, o comando a seguir cria o gas
alias para o Get-AuthenticodeSignature
cmdlet:
New-Alias -Name gas -Value Get-AuthenticodeSignature
Depois de criar o alias nome do cmdlet, você pode usar o alias nome do cmdlet em vez do nome. Por exemplo, para obter a Authenticode assinatura do SqlScript.ps1
arquivo, digite:
Get-AuthenticodeSignature SqlScript.ps1
Ou digite:
gas SqlScript.ps1
Se você criar word
como o alias Microsoft Office Word, poderá digitar "word" em vez do seguinte:
"C:\Program Files\Microsoft Office\Office11\Winword.exe"
Aliases internos
O PowerShell inclui um conjunto de aliases internos, incluindo cd
e para o Set-Location
cmdlet, ls
e dir
no Windows e dir
no Linux e macOS para o Get-ChildItem
cmdlet.chdir
Para obter todos os aliases no computador, incluindo os aliases internos, digite:
Get-Alias
Cmdlets de Alias
O PowerShell inclui os seguintes cmdlets, que são projetados para trabalhar com aliases:
Get-Alias
- Obtém todos os aliases na sessão atual.New-Alias
- Cria um novo aliasarquivo .Set-Alias
- Cria ou altera um aliasarquivo .Remove-Alias
- Exclui um aliasarquivo .Export-Alias
- Exporta um ou mais aliases para um arquivo.Import-Alias
- Importa um alias arquivo para o PowerShell.
Para obter informações detalhadas sobre os cmdlets, digite:
Get-Help <cmdlet-Name> -Detailed
Por exemplo, digite:
Get-Help Export-Alias -Detailed
Criando um alias
Para criar um novo alias, use o New-Alias
cmdlet. Por exemplo, para criar o gh
alias para Get-Help
, digite:
New-Alias -Name gh -Value Get-Help
Você pode usar os alias comandos in, assim como usaria o nome completo do cmdlet, e pode usar os alias parâmetros with.
Por exemplo, para obter Ajuda detalhada para o Get-CimInstance
cmdlet, digite:
Get-Help Get-CimInstance -Detailed
Ou digite:
gh Get-CimInstance -Detailed
Salvando aliases
Os aliases que você cria são salvos somente na sessão atual. Para usar os aliases em uma sessão diferente, adicione-o alias ao seu perfil do PowerShell. Ou use o Export-Alias
cmdlet para salvar os aliases em um arquivo.
Para obter mais informações, digite:
Get-Help about_Profiles
Obtendo aliases
Para obter todos os aliases na sessão atual, incluindo os aliases internos, os aliases em seus perfis do PowerShell e os aliases que você criou na sessão atual, digite:
Get-Alias
Para obter aliases específicos, use o parâmetro Name do Get-Alias
cmdlet. Por exemplo, para obter aliases que começam com "p", digite:
Get-Alias -Name p*
Para obter os aliases de um item específico, use o parâmetro Definition. Por exemplo, para obter os aliases para o Get-ChildItem
tipo de cmdlet:
Get-Alias -Definition Get-ChildItem
Obter saídaAlias
Get-Alias
retorna apenas um tipo de objeto, um objeto AliasInfo (System.Management.Automation.AliasInfo). O nome dos aliases que não incluem um hífen, como cd
os exibidos no seguinte formato:
Get-Alias ac
CommandType Name Version Source
----------- ---- ------- ------
Alias ac -> Add-Content
Isso torna muito rápido e fácil obter as informações de que você precisa.
O formato de nome baseado em alias 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, e o autor pode não querer que eles sejam tão evidentes.
Nomes alternativos para comandos com parâmetros
Você pode atribuir um alias a um cmdlet, script, função ou arquivo executável. Você não pode atribuir an alias a um comando e seus parâmetros. Por exemplo, você pode atribuir um alias ao Get-Eventlog
cmdlet, mas não pode atribuir um alias ao Get-Eventlog -LogName System
comando.
Você pode criar uma função que inclua o comando. Para criar uma função, digite a palavra "função" seguida de um nome para a função. Digite o comando e coloque-o entre chaves ({}).
Por exemplo, o comando a seguir cria a função syslog. Esta função representa o Get-Eventlog -LogName System
comando:
function Get-SystemEventlog {Get-Eventlog -LogName System}
Set-Alias -Name syslog -Value Get-SystemEventlog
Agora você pode digitar "syslog" em vez do comando. E você pode criar aliases para a nova função.
Para obter mais informações sobre funções, digite:
Get-Help about_Functions
Objetos Alias
Os aliases do PowerShell são representados por objetos que são instâncias da classe System.Management.Automation.AliasInfo. Para obter mais informações sobre esse tipo de objeto, consulte Classe AliasInfo no SDK do PowerShell.
Para exibir as propriedades e os métodos dos alias objetos, obtenha os aliases.
Em seguida, canalize-os para o Get-Member
cmdlet. Por exemplo:
Get-Alias | Get-Member
Para exibir os valores das propriedades de um , aliascomo o dir
alias, obtenha o alias. Em seguida, canalize-o para o Format-List
cmdlet. Por exemplo, o comando a seguir obtém o dir
alias. Em seguida, o comando canaliza o alias para o Format-List
cmdlet. Em seguida, o comando usa o parâmetro Property of Format-List
com um caractere curinga (*
) para exibir todas as propriedades do dir
alias. O comando a seguir executa estas tarefas:
Get-Alias -Name dir | Format-List -Property *
Provedor do PowerShell Alias
O PowerShell inclui o Alias provedor. O Alias provedor permite que você exiba os aliases no PowerShell como se eles estivessem em uma unidade do sistema de arquivos.
O Alias provedor expõe a Aliasunidade :. Para entrar na Aliasunidade :, digite:
Set-Location Alias:
Para exibir o conteúdo da unidade, digite:
Get-ChildItem
Para exibir o conteúdo da unidade de outra unidade do PowerShell, inicie o caminho com o nome da unidade. Inclua os dois pontos (:). Por exemplo:
Get-ChildItem -Path Alias:
Para obter informações sobre um determinado alias, digite o nome da unidade e o alias nome. Ou digite um padrão de nome. Por exemplo, para obter todos os aliases que começam com "p", digite:
Get-ChildItem -Path Alias:p*
Para obter mais informações sobre o provedor do PowerShell Alias , digite:
Get-Help Alias