Compartilhar via


Como usar aliases

Um alias é um nome alternativo ou um nome abreviado para um cmdlet ou para um elemento de comando, como uma função, script, arquivo ou arquivo executável. Você pode executar o comando usando o alias em vez do nome executável.

Gerenciando aliases de comando

O PowerShell fornece cmdlets para gerenciar aliases de comando. O comando a seguir mostra os cmdlets que gerenciam aliases.

Get-Command -Noun Alias
CommandType Name         Version Source
----------- ----         ------- ------
Cmdlet      Export-Alias 7.0.0.0 Microsoft.PowerShell.Utility
Cmdlet      Get-Alias    7.0.0.0 Microsoft.PowerShell.Utility
Cmdlet      Import-Alias 7.0.0.0 Microsoft.PowerShell.Utility
Cmdlet      New-Alias    7.0.0.0 Microsoft.PowerShell.Utility
Cmdlet      Remove-Alias 7.0.0.0 Microsoft.PowerShell.Utility
Cmdlet      Set-Alias    7.0.0.0 Microsoft.PowerShell.Utility

Para obter mais informações, consulte about_Aliases.

Use o cmdlet Get-Alias para listar os aliases disponíveis em seu ambiente. Para listar os aliases de um único cmdlet, use o parâmetro Definição e especifique o nome executável.

Get-Alias -Definition Get-ChildItem
CommandType     Name
-----------     ----
Alias           dir -> Get-ChildItem
Alias           gci -> Get-ChildItem
Alias           ls -> Get-ChildItem

Para obter a definição de um único alias, use o parâmetro Name .

Get-Alias -Name gci
CommandType     Name
-----------     ----
Alias           gci -> Get-ChildItem

Para criar um alias, use o Set-Alias comando. Você pode criar aliases para cmdlets, funções, scripts e arquivos de executáveis nativos.

Set-Alias -Name np -Value Notepad.exe
Set-Alias -Name cmpo  -Value Compare-Object

Aliases de compatibilidade no Windows

O PowerShell tem vários aliases que permitem que o Unix e cmd.exe os usuários usem comandos familiares no Windows. A tabela a seguir mostra comandos comuns, o cmdlet do PowerShell relacionado e o alias do PowerShell:

Shell de comando do Windows Comando Unix Cmdlet do PowerShell Alias do PowerShell
cd, chdir cd Set-Location sl, , cdchdir
cls clear Clear-Host cls clear
copy cp Copy-Item cpi, , cpcopy
del, erase, , rdrmdir rm Remove-Item ri, del, erase, rd, , rmrmdir
dir ls Get-ChildItem gci, , dirls
echo echo Write-Output write echo
md mkdir New-Item ni
move mv Move-Item mi, , movemv
popd popd Pop-Location popd
pwd Get-Location gl, , pwd$PWD
pushd pushd Push-Location pushd
ren mv Rename-Item rni, ren
type cat Get-Content gc, , cattype

Observação

Os aliases nesta tabela são específicos do Windows. Alguns aliases não estão disponíveis em outras plataformas para permitir que um comando nativo existente funcione em uma sessão do PowerShell. Por exemplo, ls não é definido como um alias do PowerShell no macOS ou linux para que o PowerShell execute o comando nativo em vez de Get-ChildItem.

Criando nomes alternativos para comandos com parâmetros

Você pode atribuir um alias a um cmdlet, script, função ou arquivo executável. Ao contrário de alguns shells do Unix, a definição do alias não pode incluir 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ê deve criar uma função que contenha o comando com parâmetros.

Para obter mais informações, consulte about_Aliases.

Aliases de parâmetro e nomes de taquigrafia

O PowerShell também fornece maneiras de criar nomes de taquigrafia para parâmetros. Os aliases de parâmetro são definidos usando o Alias atributo quando você declara o parâmetro. Os aliases de parâmetro não podem ser definidos usando os *-Alias cmdlets.

Para obter mais informações, consulte a documentação do atributo Alias .

Além dos aliases de parâmetro, o PowerShell permite especificar o nome do parâmetro usando o menor número de caracteres necessários para identificar exclusivamente o parâmetro. Por exemplo, o Get-ChildItem cmdlet tem os parâmetros Recurse e ReadOnly . Para identificar exclusivamente o parâmetro Recurse, você só precisa fornecer -Rec. Se você combinar isso com o alias de comando, Get-ChildItem -Recurse poderá ser reduzido para dir -Rec.

Não use aliases em scripts

Os aliases são um recurso de conveniência a ser usado interativamente no shell. Você sempre deve usar os nomes de comando e parâmetro completos em seus scripts.

  • Você pode excluir ou redefinir aliases em um script de perfil
  • Os aliases definidos em seu perfil não estão disponíveis para outros usuários
  • Os aliases tornam seu código mais difícil de ler e manter