Alias Provider
Nome do provedor
Alias
Unidades
Alias:
Descrição resumida
Fornece acesso aos aliases do Windows PowerShell e aos valores que eles representam.
Descrição detalhada
O provedor Alias do Windows PowerShell permite obter, adicionar, alterar, limpar e excluir aliases no Windows PowerShell.
Um alias é um nome alternativo para um cmdlet, uma função ou um arquivo executável. O Windows PowerShell inclui um conjunto de aliases internos. Além disso, você poderá adicionar seus próprios aliases à sessão atual e ao seu perfil do Windows PowerShell.
O provedor Alias é um namespace comum que contém apenas os objetos de alias. Os aliases não têm itens filhos.
Cada alias é uma instância da classe System.Management.Automation.AliasInfo.
O provedor Alias expõe seu repositório de dados na unidade Alias:. Para trabalhar com aliases, você pode alterar o local para a unidade Alias: usando o seguinte comando:
Set-Location alias:
Ou trabalhar de qualquer outra unidade do Windows PowerShell. Para fazer referência a um alias de outro local, use o nome da unidade Alias: no caminho.
O Windows PowerShell inclui um conjunto de cmdlets designados para exibir e alterar aliases:
Export-Alias
Get-Alias
Import-Alias
New-Alias
Set-Alias
Ao usar esses cmdlets, você não precisa especificar a unidade Alias: no nome.
O provedor Alias dá suporte a todos os cmdlets que contenham Item em seus nomes, exceto o cmdlet Invoke-Item. Além disso, ele dá suporte aos cmdlets Get-Content e Set-Content. O provedor Alias não dá suporte aos cmdlets que contenham ItemProperty em seus nomes. E não dá suporte ao parâmetro Filter em nenhum cmdlet.
Todas as alterações nos aliases afetam apenas a sessão atual. Para salvar as alterações, adicione-as ao perfil do Windows PowerShell. Ou use os cmdlets Export-Alias e Import-Alias.
Exemplos
Obtendo a unidade Alias:
-------------------------- EXEMPLO 1 --------------------------
Este comando altera o local atual para a unidade Alias:. Você pode utilizar o comando em qualquer unidade do Windows PowerShell. Para retornar a uma unidade do sistema de arquivos, digite o nome da unidade. Por exemplo, digite "set-location c:".
set-location alias:
Obtendo aliases
-------------------------- EXEMPLO 1 --------------------------
Este comando obtém uma lista de todos os aliases na sessão atual. Você pode utilizar o comando em qualquer unidade do Windows PowerShell.
get-item -path alias:
-------------------------- EXEMPLO 2 --------------------------
Este comando obtém o alias "ls". Como ele inclui o caminho, você pode usá-lo em qualquer unidade do Windows PowerShell.
get-item -path alias:ls
Se você estiver na unidade Alias:, poderá omitir o nome da unidade no caminho.
-------------------------- EXEMPLO 3 --------------------------
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"}
Quando o item com alias é um arquivo executável, a propriedade Definition contém o caminho totalmente qualificado do arquivo.
-------------------------- EXEMPLO 4 --------------------------
Este comando obtém a lista de todos os aliases quando o local atual é a unidade Alias:. Ele usa um caractere curinga (*) para indicar todo o conteúdo do local atual.
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 *" geram o mesmo resultado.
Criando um novo alias
-------------------------- EXEMPLO 1 --------------------------
Este comando cria o alias "serv" para o cmdlet Get-Service. Como o local atual está na unidade Alias:, o valor do parâmetro Path é um ponto (.). O ponto (.) representa o local atual.
Este comando também utiliza o parâmetro dinâmico Options para definir as opções AllScope e Constant no alias. O parâmetro Options está disponível no cmdlet New-Item somente quando você está na unidade Alias:.
new-item -path . -name serv -value Get-Service -Options "AllScope,Constant"
Se você estiver na unidade Alias:, poderá omitir o nome da unidade no caminho.
-------------------------- EXEMPLO 2 --------------------------
Você pode criar um alias para qualquer item que chama um comando. Este comando cria o alias "np" para Notepad.exe.
new-item -path alias:np -value c:\windows\notepad.exe
-------------------------- EXEMPLO 3 --------------------------
Você pode criar um alias para qualquer função. Você pode utilizar esse recurso para criar um alias que inclui 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. O ponto-e-vírgula (;) é o separador de comando.
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
Exibindo as propriedades e os métodos de aliases
-------------------------- EXEMPLO 1 --------------------------
Este comando usa o cmdlet Get-Item para obter todos os aliases. O operador de pipeline (|) envia os resultados para o cmdlet Get-Member, que exibe os métodos e as propriedades do objeto.
get-item -path alias:* | get-member
Quando você canaliza uma coleção de objetos para Get-Member, como a coleção de aliases na unidade Alias:, Get-Member avalia cada objeto da coleção separadamente. Em seguida, Get-Member retorna as informações sobre cada tipo de objeto que localiza. Se todos os objetos forem do mesmo tipo, ele retornará informações sobre o único tipo de objeto. Neste caso, todos os aliases são objetos AliasInfo. Para obter informações sobre a coleção de objetos AliasInfo, use o parâmetro InputObject de Get-Member. Por exemplo, use o seguinte comando: Get-Member -InputObject (Get-Item alias:*) Quando você usa InputObject, Get-Member avalia a coleção, não os objetos da coleção.
-------------------------- EXEMPLO 2 --------------------------
Este comando lista os valores das propriedades do alias "dir". Ele usa o cmdlet Get-Item para obter um objeto que representa o alias "dir". O operador de pipeline (|) envia os resultados para o comando Format-List. O comando Format-List usa o parâmetro Property com um caractere curinga (*) para formatar e exibir os valores de todas as propriedades do alias "dir".
get-item alias:dir | format-list -property *
Alterando as propriedades de um alias
-------------------------- EXEMPLO 1 --------------------------
Você poderá 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 AllScope e ReadOnly para o alias "dir". O comando usa o parâmetro dinâmico Options do cmdlet Set-Item. O parâmetro Options fica disponível em Set-Item somente quando é utilizado com o provedor Alias ou Function.
set-item -path alias:dir -options "AllScope,ReadOnly"
-------------------------- EXEMPLO 2 --------------------------
Este comando usa o cmdlet Set-Item para alterar o alias "gp", de forma que ele represente o cmdlet Get-Process, em vez de Get-ItemProperty. O parâmetro Force é obrigatório, pois o valor da propriedade Options do alias "gp" está definido como ReadOnly. Como o comando é enviado 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 *
-------------------------- EXEMPLO 3 --------------------------
Este comando usa o cmdlet Rename-Item para alterar o alias "popd" para "pop".
rename-item -path alias:popd -newname pop
Copiando um alias
-------------------------- EXEMPLO 1 --------------------------
Este comando copia o alias pushd, de forma que um novo alias push é criado para o cmdlet Push-Location.
copy-item -path alias:pushd -destination alias:push
Quando o novo alias é criado, sua propriedade Description tem um valor nulo. Além disso, sua propriedade Option tem um valor None. Se o comando for emitido da unidade Alias:, você poderá omitir o nome da unidade no valor do parâmetro Path.
Excluindo um alias
-------------------------- EXEMPLO 1 --------------------------
Este comando exclui o alias serv da sessão atual. Você pode utilizar o comando em qualquer unidade do Windows PowerShell.
remove-item -path alias:serv
Se você estiver na unidade Alias:, poderá omitir o nome da unidade no caminho.
-------------------------- EXEMPLO 2 --------------------------
Este comando exclui aliases que começam com "s". Ele não exclui aliases somente leitura.
clear-item -path alias:s*
-------------------------- EXEMPLO 3 --------------------------
Este comando exclui todos os aliases da sessão atual, exceto aqueles com um valor Constant para suas propriedades Options. Sem o parâmetro Force, o comando não exclui aliases cujas propriedades Options tenham um valor ReadOnly.
remove-item alias:* -force
Parâmetros dinâmicos
Parâmetros dinâmicos são parâmetros de cmdlets, que são adicionados por um provedor do Windows PowerShell e estão disponíveis apenas quando o cmdlet está sendo usado na unidade habilitada pelo provedor.
Options <System.Management.Automation.ScopedItemOptions>
Determina o valor da propriedade Options de um alias.
| Value | Description |
|---|---|
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 apenas 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, a não ser com o uso do parâmetro Force. É possível usar Remove-Item para excluir o alias. |
AllScope |
O alias é copiado para os novos escopos que forem criados. |