Partilhar via

Remove-Alias

Módulo:
Microsoft.PowerShell.Utility Module

Remova um alias da sessão atual.

Sintaxe

Default (Predefiniçã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 os aliases com a propriedade Opções de 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 Options propriedade representam o objeto de pipeline atual. O operador -ne (não igual) seleciona objetos que não têm um valor de Opções 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 de 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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica o nome do alias a ser removido.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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)

Propriedades dos parâmetros

Tipo:String
Default value:Local
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 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 comando Remove-Alias ao seu perfil do PowerShell.

Para obter mais informações, consulte about_Aliases.