sobre_Provedor_de_Alias

Nome do fornecedor

Alias

Drives

Alias:

Capabilities

Deve Processar

Descrição detalhada

O provedor de Alias do PowerShell permite obter, adicionar, alterar, limpar e excluir aliases no PowerShell.

Um alias é um nome alternativo para um cmdlet, função, arquivo executável, incluindo scripts. O PowerShell inclui um conjunto de aliases internos. Você pode adicionar seus próprios aliases à sessão atual e ao seu perfil do PowerShell.

A unidade Alias é um namespace simples que contém apenas os objetos de alias. Os pseudónimos não têm itens filhos.

O provedor de Alias oferece suporte aos cmdlets a seguir, abordados neste artigo.

• Obter-Localização
• Set-Location
• Get-Item
• Novo Item
• Remove-Item
• Limpar-Item

O PowerShell inclui um conjunto de cmdlets projetados para exibir e alterar aliases. Ao usar cmdlets Alias, não é necessário especificar a unidade Alias: no nome. Este artigo não aborda o uso de cmdlets Alias.

• Exportação-Alias
• Obter-Alias
• Importação -Alias
• Novo-Alias
• Conjunto-Alias

Tipos expostos por este provedor

Cada alias é uma instância da classe System.Management.Automation.AliasInfo.

Navegando na unidade de alias

O provedor de Alias expõe seu armazenamento de dados na unidade Alias:. Para trabalhar com aliases, o utilizador pode alterar a sua localização para a drive Alias: usando o seguinte comando:

Set-Location Alias:

Para retornar a uma unidade do sistema de arquivos, digite o nome da unidade. Por exemplo, digite:

Set-Location C:

Você também pode trabalhar com o provedor do Alias a partir de qualquer outra unidade do PowerShell. Para fazer referência a um alias de outro local, use o nome do drive Alias: no caminho.

Exibindo o conteúdo do Alias: drive

Este comando obtém a lista de todos os aliases quando o local atual é o drive Alias:. Ele usa um caractere curinga * para indicar todos os conteúdos do local atual.

PS Alias:\> Get-Item -Path *

Na unidade Alias:, um ponto ., que representa o local atual, e um caractere curinga *, que representa todos os itens no local atual, têm o mesmo efeito. Por exemplo, Get-Item -Path . ou Get-Item \* produzem o mesmo resultado.

O provedor de Alias não tem contêineres, portanto, o comando acima tem o mesmo efeito quando usado com Get-ChildItem.

Get-ChildItem -Path Alias:

Obter um alias selecionado

Este comando obtém o alias ls. Como inclui o caminho, pode-se usá-lo em qualquer unidade do PowerShell.

Get-Item -Path Alias:ls

Se estiveres na unidade Alias:, podes omitir o nome da unidade do caminho.

Você também pode obter a definição de um alias ao prefixar o caminho do provedor com o sinal de dólar ($).

$Alias:ls

Obter todos os aliases para um cmdlet específico

Este comando obtém uma lista dos aliases associados ao cmdlet Get-ChildItem. Ele usa a propriedade Definition, que armazena o nome do cmdlet.

Get-Item -Path Alias:* | Where-Object {$_.Definition -eq "Get-ChildItem"}

Criação de aliases

Crie um alias a partir da unidade Alias:

Este comando cria o alias de serv para o cmdlet Get-Service. Como o local atual está na unidade Alias:, o parâmetro -Path não é necessário.

Este comando também usa o parâmetro dinâmico -Options para definir a opção AllScope no alias. O parâmetro -Options está disponível no cmdlet New-Item apenas quando estás na unidade Alias:. O ponto (.) indica o diretório atual, que é a Alias: unidade.

PS Alias:\> New-Item -Path . -Name serv -Value Get-Service -Options "AllScope"

Criar um alias com um caminho absoluto

Você pode criar um alias para qualquer item que invoque um comando. Este comando cria o alias np para Notepad.exe.

New-Item -Path Alias:np -Value C:\windows\notepad.exe

Criar um alias para uma nova função

Você pode criar um alias para qualquer função. Você pode usar esse recurso para criar um alias que inclua um cmdlet e seus parâmetros.

O primeiro comando cria a função CD32, que altera o diretório atual para o diretório System32. O segundo comando cria o alias go para a função CD32.

Quando o comando estiver concluído, você poderá usar CD32 ou go para invocar a função.

function CD32 {Set-Location -Path C:\windows\system32}
Set-Item -Path Alias:go -Value CD32

Alterar aliases

Alterar as opções de um alias

Você pode usar o cmdlet Set-Item com o parâmetro dinâmico -Options para alterar o valor da propriedade -Options de um alias.

Este comando define as opções ReadOnly para e no alias . O comando usa o parâmetro dinâmico -Options do cmdlet Set-Item. O parâmetro -Options está disponível em Set-Item quando o utilizador o utiliza com o provedor da função Alias ou .

Set-Item -Path Alias:dir -Options "AllScope, ReadOnly"

Alterar um comando associado a um alias.

Este comando usa o cmdlet Set-Item para alterar o alias de gp para que ele represente o cmdlet Get-Process em vez do cmdlet Get-ItemProperty. O parâmetro é necessário porque o valor da propriedade Opções do alias está definido como . Como o comando é enviado de dentro da unidade Alias:, a unidade não é especificada no caminho.

Set-Item -Path gp -Value Get-Process -Force

A alteração afeta as quatro propriedades que definem a associação entre o alias e o comando. Para exibir o efeito da alteração, digite o seguinte comando:

Get-Item -Path gp | Format-List -Property *

Renomear uma alcunha

Este comando usa o cmdlet Rename-Item para alterar o alias popd para pop.

Rename-Item -Path Alias:popd -NewName pop

Copiar um alias

Este comando copia o alias de pushd para que um novo alias de push seja criado para o cmdlet Push-Location.

Quando o novo alias é criado, sua propriedade Description tem um valor nulo. E a sua propriedade Option tem um valor de None. Se o comando for emitido de dentro da unidade Alias:, você poderá omitir o nome da unidade do valor do parâmetro -Path.

Copy-Item -Path Alias:pushd -Destination Alias:push

Eliminar um alias

Este comando exclui o alias de serv da sessão atual. Você pode usar este comando em qualquer unidade do PowerShell.

Remove-Item -Path Alias:serv

Este comando exclui aliases que começam com "s". Ele não exclui aliases somente leitura.

Clear-Item -Path Alias:s*

Excluir alcunhas de leitura exclusiva

Este comando exclui todos os aliases da sessão atual, exceto aqueles com um valor de para sua propriedade Opções . O parâmetro -Force permite que o comando exclua aliases cuja propriedade Options tem um valor de ReadOnly.

Remove-Item Alias:* -Force

Parâmetros dinâmicos

Parâmetros dinâmicos são parâmetros de cmdlet adicionados por um provedor do PowerShell e estão disponíveis somente quando o cmdlet está sendo usado na unidade habilitada para provedor.

Opções [System.Management.Automation.ScopedItemOptions]

Determina o valor da propriedade Opções de um alias.

• None: Sem opções. Esse valor é o padrão.
• Constant:O alias não pode ser excluído e suas propriedades não podem ser alteradas. Constant está disponível somente quando você cria um alias. Não é possível alterar a opção de um alias existente para Constant.
• Private:O alias é visível apenas no escopo atual, não nos escopos filho.
• ReadOnly:As propriedades do alias não podem ser alteradas, exceto usando o parâmetro -Force. Você pode usar Remove-Item para excluir o alias.
• AllScope:O alias é copiado para quaisquer novos contextos criados.

Cmdlets suportados

• Novo Item
• Definir-Item

Usando o pipeline

Os cmdlets do provedor aceitam entrada de pipeline. Você pode usar o pipeline para simplificar as suas tarefas enviando dados do provedor de um cmdlet para outro cmdlet do provedor. Para ler mais sobre como usar o pipeline com cmdlets do fornecedor, consulte as referências de cmdlet fornecidas ao longo deste artigo.

Obter ajuda

A partir do Windows PowerShell 3.0, pode-se obter tópicos de ajuda personalizados para cmdlets de provedor que explicam como esses cmdlets se comportam numa unidade de disco do sistema de ficheiros.

Para obter os tópicos de ajuda personalizados para a unidade do sistema de arquivos, execute um comando Get-Help em uma unidade do sistema de arquivos ou use o parâmetro -Path de Get-Help para especificar uma unidade do sistema de arquivos.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path Alias:

Consulte também

• about_Aliases
• about_Providers