Remove-Alias
Remova um alias da sessão atual.
Syntax
Remove-Alias
[-Name] <String[]>
[-Scope <String>]
[-Force]
[<CommonParameters>]
Description
O Remove-Alias
cmdlet remove um alias da sessão atual do PowerShell. Para remover um alias com a propriedade Option definida como ReadOnly, use o parâmetro Force .
O cmdlet Remove-Alias
foi introduzido no PowerShell 6.0.
Exemplos
Exemplo 1 – Remover um alias
Este exemplo remove um alias chamado del
que representa o Remove-Item
cmdlet .
Remove-Alias -Name del
Exemplo 2 – Remover todos os aliases não constantes
Este exemplo remove todos os aliases da sessão atual do PowerShell, exceto para aliases com a propriedade Options definida como Constante. Depois que o comando for executado, os aliases estarão disponíveis em outras sessões do PowerShell ou em novas sessões do PowerShell.
Get-Alias | Where-Object { $_.Options -NE "Constant" } | Remove-Alias -Force
Get-Alias
obtém todos os aliases na sessão do PowerShell e envia os objetos para baixo do pipeline.
Where-Object
usa um bloco de script e a variável automática ($_
) e a propriedade Options representam o objeto de pipeline atual. O parâmetro NE (não é igual), seleciona objetos que não têm um valor Options definido como Constante. Remove-Alias
usa o parâmetro Force para remover aliases, incluindo aliases somente leitura, da sessão do PowerShell.
Parâmetros
-Force
Indica que o cmdlet remove um alias, incluindo aliases com a propriedade Option definida como ReadOnly. O parâmetro Force não pode remover um alias com uma propriedade Option definida como Constante.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica o nome do alias a ser removido.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Scope
Afeta apenas os aliases no escopo especificado. O escopo padrão é Local. Para obter mais informações, consulte about_Scopes.
Os valores aceitáveis para esse parâmetro são:
Global
Local
Script
- Um número relativo ao escopo atual (0 pelo número de escopos, em que 0 é o escopo atual e 1 é seu pai)
Type: | String |
Position: | Named |
Default value: | Local |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
String[]
Você pode redirecionar um objeto de alias para Remove-Alias
.
Saídas
None
Esse cmdlet não retorna nenhuma saída.
Observações
As alterações afetam apenas o escopo atual. Para remover um alias de todas as sessões, adicione um Remove-Alias
comando ao seu perfil do PowerShell.
Para obter mais informações, consulte about_Aliases.