Compartilhar via

Remove-Alias

Módulo:
Microsoft.PowerShell.Utility Module

Remova um alias da sessão atual.

Sintaxe

Default (Padrão) 

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 Options definida como Constant. 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 a propriedade Options representam o objeto de pipeline atual. O operador -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 de leitura, da sessão do PowerShell. O parâmetro Force não pode remover aliases de Constant.

Parâmetros

-Force

Indica que o cmdlet remove um alias, incluindo aliases cuja propriedade Option está definida como ReadOnly. O parâmetro Force não pode remover um alias com uma propriedade Option definida como Constant.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome do alias a ser removido.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Scope

Afeta somente 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 (variando de 0 até o número total de escopos, onde 0 é o escopo atual e 1 é o escopo pai)

Propriedades do parâmetro

Tipo:String
Valor padrão:Local
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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.