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