about_Alias_Provider
Nome do fornecedor
Alias
Unidades
Alias:
Capacidades
DeveProcessar
Breve descrição
Fornece acesso aos aliases do PowerShell e aos valores que eles representam.
Descrição detalhada
O provedor do PowerShell Alias 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 aliases não têm itens filho.
O Alias provedor oferece suporte aos cmdlets a seguir, que são abordados neste artigo.
O PowerShell inclui um conjunto de cmdlets projetados para exibir e alterar aliases. Ao usar Alias cmdlets, não é necessário especificar a Alias: unidade no nome. Este artigo não aborda o trabalho com Alias cmdlets.
Tipos expostos por este provedor
Cada alias é uma instância da classe
Navegar na Alias unidade
O Alias provedor expõe seu armazenamento de dados na Alias: unidade. Para trabalhar com aliases, você pode alterar seu local para a Alias: unidade usando o seguinte comando:
Set-Location Alias:
Para retornar a uma unidade do sistema de arquivos, digite o nome da unidade. Por exemplo, escreva:
Set-Location C:
Você também pode trabalhar com o Alias provedor de qualquer outra unidade do PowerShell. Para fazer referência a um alias de outro local, use o nome da unidade Alias: no caminho.
Nota
O PowerShell usa aliases para permitir uma maneira familiar de trabalhar com caminhos de provedor. Comandos como dir e ls agora são aliases no Windows e dir no Linux e macOS para Get-ChildItem, cd é um alias para Set-Location e pwd é um alias para Get-Location.
Exibindo o conteúdo da Aliasunidade :
Este comando obtém a lista de todos os aliases quando o local atual é a Alias: unidade. Ele usa um caractere * curinga para indicar todo o conteúdo do local atual.
PS Alias:\> Get-Item -Path *
Alias: Na unidade, 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 \* produzir o mesmo resultado.
O Alias provedor não tem contêineres, portanto, o comando acima tem o mesmo efeito quando usado com Get-ChildItemo .
Get-ChildItem -Path Alias:
Obter um alias selecionado
Este comando obtém o alias ls.
Como ele inclui o caminho, você pode usá-lo em qualquer unidade do PowerShell.
Get-Item -Path Alias:ls
Se você estiver na Alias: unidade, poderá omitir o nome da unidade do caminho.
Você também pode recuperar a definição de um alias prefixando o caminho do provedor com o cifrão ($).
$Alias:ls
Obter todos os aliases para um cmdlet específico
Este comando obtém uma lista dos aliases associados ao Get-ChildItem cmdlet. Ele usa a Definition propriedade, 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 Alias: unidade, o -Path parâmetro não é necessário.
Este comando também usa o parâmetro dinâmico -Options para definir a opção AllScope no alias. O -Options parâmetro está disponível no New-Item cmdlet somente quando você está na Alias: unidade. O ponto (.) indica o diretório atual, que é o drive de alias.
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 CD32 função, que altera o diretório atual para o System32 diretório. O segundo comando cria o alias go para a função CD32.
Quando o comando estiver concluído, você poderá usar uma ou CD32go 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 de -Options parâmetro dynamic do Set-Item cmdlet. O -Options parâmetro está disponível quando Set-Item você o usa com o Alias provedor ou Function .
Set-Item -Path Alias:dir -Options "AllScope, ReadOnly"
Alterar um comando referenciado de aliases
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 Alias: unidade, 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 Option propriedade tem um valor de None. Se o comando for emitido de dentro da Alias: unidade, você poderá omitir o nome da unidade do valor do -Path parâmetro.
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 esse 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 aliases somente leitura
Este comando exclui todos os aliases da sessão atual, exceto aqueles com um valor de Constant para sua propriedade Options . O -Force parâmetro 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. Este valor é a predefiniçã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 subescopos.
-
ReadOnly:As propriedades do alias não podem ser alteradas, exceto usando o parâmetro
-Force. Você pode usarRemove-Itempara excluir o alias. - AllScope:O alias é copiado para quaisquer novos âmbitos que sejam criados.
Cmdlets suportados
Usando o pipeline
Os cmdlets do provedor aceitam entrada de pipeline. Você pode usar o pipeline para simplificar a tarefa enviando dados do provedor de um cmdlet para outro cmdlet do provedor. Para ler mais sobre como usar o pipeline com cmdlets de provedor, consulte as referências de cmdlet fornecidas ao longo deste artigo.
Obter ajuda
A partir do Windows PowerShell 3.0, você pode obter tópicos de ajuda personalizados para cmdlets de provedor que explicam como esses cmdlets se comportam em uma unidade do sistema de arquivos.
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 -Path parâmetro Get-Help para especificar uma unidade do sistema de arquivos.
Get-Help Get-ChildItem
Get-Help Get-ChildItem -Path alias:
