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 Remove-Alias cmdlet 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 (não igual) seleciona objetos que não têm um valor Options definido como Constant. 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 Constant .

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
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome do alias a ser removido.

Tipo:String[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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 através do número de escopos, onde 0 é o escopo atual e 1 é seu pai)
Tipo:String
Position:Named
Default value:Local
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String[]

Você pode canalizar um objeto alias para esse cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

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.