Compartilhar via

Remove-Alias

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Remova um alias da sessão atual.

Sintaxe

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 os aliases com a propriedade Options definida como Constant. Depois que o comando é executado, os aliases ficam 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 pelo 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 (diferente de) seleciona objetos que não têm um valor de Opções definido como Constante. Remove-Alias usa o parâmetro Force para remover aliases, incluindo aliases somente leitura, da sessão do PowerShell. O parâmetro Force não pode remover aliases constantes .

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 Constant.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome do alias a ser removido.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 até o número de escopos, em que 0 é o escopo atual e 1 é seu pai)
Tipo:String
Cargo:Named
Valor padrão:Local
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String[]

Você pode canalizar um objeto de alias para esse cmdlet.

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.