Sobre aliases

DESCRIÇÃO BREVE

Descreve como usar nomes alternativos para cmdlets e comandos no PowerShell.

DESCRIÇÃO LONGA

Um 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 em vez do nome do comando em qualquer comando do PowerShell.

Para criar um alias, use o cmdlet New-Alias. Por exemplo, o comando a seguir cria o alias "gas" para o Get-AuthenticodeSignature cmdlet:

New-Alias -Name gas -Value Get-AuthenticodeSignature

Depois de criar o alias para o nome do cmdlet, você pode usar o alias em vez 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 do 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 "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

ALIAS CMDLETS

O PowerShell inclui os seguintes cmdlets, que foram projetados para trabalhar com aliases:

  • Get-Alias - Obtém todos os aliases na sessão atual.
  • New-Alias - Cria um novo alias.
  • Set-Alias - Cria ou altera um alias.
  • Export-Alias - Exporta um ou mais aliases para um arquivo.
  • Import-Alias - Importa um arquivo de alias 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 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, assim como usaria o nome completo do cmdlet e 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 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 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 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 cmdlet Get-Alias. 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 Definição. Por exemplo, para obter os aliases para o tipo de cmdlet Get-ChildItem:

Get-Alias -Definition Get-ChildItem

SAÍDA GET-ALIAS

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", é exibido 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 necessárias.

O formato de nome de alias com base em 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 talvez o autor não queira 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 um 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. Essa 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 objetos de alias, obtenha os aliases. Em seguida, direcione-os para o cmdlet Get-Member. Por exemplo:

Get-Alias | Get-Member

Para exibir os valores das propriedades de um alias específico, como o alias dir , obtenha o alias. Em seguida, encaminhe-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 Propriedade de Format-List com um caractere curinga (*) para exibir todas as propriedades do alias dir . O comando a seguir executa estas tarefas:

Get-Alias -Name dir | Format-List -Property *

PROVEDOR de ALIAS do PowerShell

O PowerShell inclui o provedor de Alias. O provedor de Alias permite exibir os aliases no PowerShell como se estivessem em uma unidade do sistema de arquivos.

O provedor de Alias expõe o Alias: unidade. Para ir para o Alias: unidade, 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, comece 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 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 de Alias do PowerShell, digite:

Get-Help Alias

CONSULTE TAMBÉM