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 cmdlet Remove-Alias 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 cmdlet Remove-Item.

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 Opções 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 pelo pipeline. Where-Object usa um bloco de script e a variável automática ($_) e Options propriedade representam o objeto de pipeline atual. O parâmetro NE (não igual), seleciona objetos que não têm um valor opções de 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 de constante.

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 este parâmetro são:

  • Global
  • Local
  • Script
  • Um número relativo ao escopo atual (0 por meio do 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 este 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 comando Remove-Alias ao seu perfil do PowerShell.

Para obter mais informações, consulte about_Aliases.