about_Aliases
Aplica-se a: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0, Windows PowerShell 5.0
Insira a introdução aqui.
TÓPICO
about_aliases
DESCRIÇÃO BREVE
Descreve como usar nomes alternativos para os cmdlets e comandos em Windows PowerShell.
DESCRIÇÃO LONGA
Um alias é um nome alternativo ou apelido para um cmdlet ou para um elemento de comando, tal como uma função, script, arquivo ou arquivo executável. Você pode usar o alias em vez do nome do comando em qualquer Windows PowerShell comando.
Para criar um alias, use o cmdlet New-Alias. Por exemplo, o comando a seguir cria o alias "gas" para o cmdlet Get-AuthenticodeSignature:
New-Alias -Name gas -Value Get-AuthenticodeSignature
Depois de criar o alias para o nome do cmdlet, você pode usar o alias ao invés do nome do cmdlet. Por exemplo, para obter a assinatura Authenticode para o arquivo SqlScript.ps1, digite:
Get-AuthenticodeSignature SqlScript.ps1
Ou digite:
gas SqlScript.ps1
Se você criar "word" como o alias para o Microsoft Office Word, você pode digitar "word" ao invés do seguinte:
"C:\Program Files\Microsoft Office\Office11\Winword.exe"
ALIASES INTERNOS
Windows PowerShell inclui um conjunto de aliases internos, incluindo "cd" e "chdir" para o cmdlet Set-Location e "ls" e "dir" para o cmdlet Get-ChildItem.
Para obter todos os aliases no computador, incluindo os aliases internos, digite:
Get-Alias
CMDLETS DE ALIAS
Windows PowerShell inclui os seguintes cmdlets, que são projetados para trabalhar com aliases:
- Get-Alias. Gets all the aliases in the current session.
- New-Alias. Creates a new alias.
- Set-Alias. Creates or changes an alias.
- Export-Alias. Exports one or more aliases to a file.
- Import-Alias. Imports an alias file into Windows PowerShell.
Para obter mais informações sobre cmdlets, digite:
Get-Help <cmdlet-Name> -Detailed
Por exemplo, digite:
Get-Help Export-Alias -Detailed
CRIAR UM ALIAS
Para criar um novo alias, use o cmdlet New-Alias. Por exemplo, para criar o alias "gh" para Get-Help, digite:
New-Alias -Name gh -Value Get-Help
Você pode usar o alias em comandos, exatamente como você usaria o nome do cmdlet completo, e você pode usar o alias com parâmetros.
Por exemplo, para obter Ajuda detalhada para o cmdlet Get-WmiObject, digite:
Get-Help Get-WmiObject -Detailed
Ou, digite:
gh Get-WmiObject -Detailed
SALVANDO ALIASES
Os aliases criados por você são salvos somente na sessão atual. Para usar aliases em uma sessão diferente, adicione o alias ao seu Windows PowerShell perfil. Ou use o cmdlet Export-Alias 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 nos seus Windows PowerShell perfis e os aliases que você criou em sua sessão atual, digite:
Get-Alias
Para obter o alias específico, use o parâmetro Name do cmdlet Get-Alias. Por exemplo, para obter os aliases que começam com "p", digite:
Get-Alias -Name p*
Para obter os aliases para um item específico, use o parâmetro Definition. Por exemplo, para obter os aliases para o tipo cmdlet Get-ChildItem, digite:
Get-Alias -Definition Get-ChildItem
SAÍDA DE GET-ALIAS
Get-Alias retorna somente um tipo de objeto, um objeto AliasInfo (System.Management.Automation.AliasInfo). No entanto, desde o Windows PowerShell 3.0, o nome de aliases que não inclua um hífen, tal como "cd", são exibidos no seguinte formato:
<alias> -> <definition>
Por exemplo,
ac -> Add-Content
Isso faz com que seja muito rápido e fácil obter as informações que você precisa.
O formato de nome de alias baseado em seta não é usado para aliases que incluem um hífen. Eles provavelmente são nomes substitutos preferidos para cmdlets e funções, ao invés de abreviações típicas ou apelidos e o autor talvez não queira que eles sejam tão evidente.
NOMES ALTERNATIVOS PARA COMANDOS COM PARÂMETROS
Você pode atribuir um alias para um cmdlet, o script, a função ou o arquivo executável. No entanto, você não pode atribuir um alias para um comando e seus parâmetros. Por exemplo, você pode atribuir um alias para o cmdlet Get-Eventlog, mas você não pode atribuir um alias para o comando "Get-Eventlog - LogName System".
No entanto, você pode criar uma função que inclua o comando. Para criar uma função, digite a palavra "function" seguido por 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. Essa função representa o comando "Get-Eventlog -LogName System":
function syslog {Get-Eventlog -LogName System}
Agora você pode digitar "syslog" em vez do comando. E você pode criar aliases para a função de syslog.
Para obter mais informações sobre funções, digite:
Get-Help about_Functions
OBJETOS DE ALIAS
Windows PowerShell aliases são representados por objetos que são instâncias da classe System.Management.Automation.AliasInfo. Para mais informações sobre esse tipo de objeto, consulte "AliasInfo Class" na biblioteca do Microsoft Developer Network (MSDN) no endereço https://go.microsoft.com/fwlink/?LinkId=143644.
Para exibir as propriedades e métodos dos objetos de alias, obtenha os aliases. Em seguida, canalize-os para o cmdlet Get-Member. Por exemplo:
Get-Alias | Get-Member
Para exibir os valores das propriedades de um alias específico, tal como o alias "dir", obtenha o alias. Em seguida, canalize-o para o cmdlet Format-List. Por exemplo, o comando a seguir obtém o alias "dir". Em seguida, o comando canaliza o alias para o cmdlet Format-List. Em seguida, o comando usa o parâmetro Property do Format-List com um caractere curinga (*) para exibir todas as propriedades do alias "dir". O comando a seguir executa essas tarefas:
Get-Alias -Name dir | Format-List -Property *
PROVEDOR DE ALIAS DO WINDOWS POWERSHELL
Windows PowerShell inclui o provedor de Alias. O provedor de Alias permite que você exiba os aliases em Windows PowerShellcomo se estivessem em uma unidade de sistema de arquivos.
O provedor de Alias expõe o Alias: . Para ir até o Alias: , digite:
Set-Location Alias:
Para exibir o conteúdo da unidade, digite:
Get-ChildItem
Para exibir o conteúdo da unidade de outro Windows PowerShelldrive, iniciar o caminho com o nome da unidade. Inclua os dois-pontos (:). Por exemplo:
Get-ChildItem -Path Alias:
Para obter informações sobre um alias específico, digite o nome da unidade e o nome do alias. Ou, digite um nome padrão. Por exemplo, para obter todos os aliases que começam com "p", digite:
Get-ChildItem -Path Alias:p*
Para obter mais informações sobre Windows PowerShello provedor de Alias, digite:
Get-Help Alias
CONSULTE TAMBÉM
New-Alias
Get-Alias
set-alias
export-alias
import-alias
get-psprovider
get-psdrive
about_functions
about_profiles
about_providers