Partilhar via


Utilizar pseudónimos

Um alias é um nome alternativo ou 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 Definition 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 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 seguinte mostra comandos comuns, o cmdlet PowerShell relacionado e o alias PowerShell:

Shell de Comando do Windows Comando Unix O cmdlet do PowerShell Alias do PowerShell
cd, chdir cd Set-Location sl, cd, chdir
cls clear Clear-Host cls clear
copy cp Copy-Item cpi, cp, copy
del, erase, rd, rmdir rm Remove-Item ri, del, erase, rd, rm, rmdir
dir ls Get-ChildItem gci, dir, ls
echo echo Write-Output write echo
md mkdir New-Item ni
move mv Move-Item mi, move, mv
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, cat, type

Observação

Os aliases nesta tabela são específicos do Windows. Alguns aliases não estão disponíveis noutras plataformas para permitir que um comando nativo existente funcione numa sessão PowerShell. Por exemplo, ls não é definido como um alias 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 Unix, a definição do alias não pode incluir parâmetros. Por exemplo, podes atribuir um alias ao Get-Eventlog cmdlet, mas não podes 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âmetros e nomes abreviados

O PowerShell também fornece maneiras de criar nomes abreviados para parâmetros. Os aliases de parâmetro são definidos usando o Alias atributo quando você declara o parâmetro. Os alias de parâmetros 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 de forma única o parâmetro Recurse, basta fornecer -Rec. Se você combinar isso com o alias de comando, Get-ChildItem -Recurse pode ser encurtado para dir -Rec.

Não use aliases em scripts

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

  • Pode apagar ou redefinir aliases num script de perfil
  • Os pseudónimos que defines no teu perfil não estarão disponíveis para outros utilizadores
  • Os aliases tornam o código mais difícil de ler e manter