Condividi tramite

Remove-Alias

Modulo:
Microsoft.PowerShell.Utility Module

Rimuovere un alias dalla sessione corrente.

Sintassi

Default (impostazione predefinita). 

Remove-Alias
    [-Name] <String[]>
    [-Scope <String>]
    [-Force]
    [<CommonParameters>]

Descrizione

Il cmdlet Remove-Alias rimuove un alias dalla sessione di PowerShell corrente. Per rimuovere un alias con la proprietà Option impostata su ReadOnly, usa il parametro Force.

Il cmdlet Remove-Alias è stato introdotto in PowerShell 6.0.

Esempio

Esempio 1 - Rimuovere un alias

In questo esempio viene rimosso un alias denominato del che rappresenta il cmdlet Remove-Item.

Remove-Alias -Name del

Esempio 2- Rimuovere tutti gli alias non costanti

In questo esempio vengono rimossi tutti gli alias dalla sessione di PowerShell corrente, ad eccezione degli alias con la proprietà Opzioni impostata su Costante. Dopo l'esecuzione del comando, gli alias sono disponibili in altre sessioni di PowerShell o in nuove sessioni di PowerShell.

Get-Alias | Where-Object { $_.Options -ne "Constant" } | Remove-Alias -Force

Get-Alias ottiene tutti gli alias nella sessione di PowerShell e invia gli oggetti attraverso la pipeline. Where-Object utilizza un blocco di script, e la variabile automatica ($_) e la proprietà Opzioni rappresentano l'oggetto corrente della pipeline. L'operatore -ne (diverso da uguale) seleziona gli oggetti che non dispongono di un valore Options impostato su Costante. Remove-Alias usa il parametro Force per rimuovere gli alias, inclusi gli alias di sola lettura, dalla sessione di PowerShell. Il parametro Force non può rimuovere gli alias Constant.

Parametri

-Force

Indica che il cmdlet rimuove un alias, inclusi gli alias con la proprietà opzione impostata su ReadOnly. Il parametro Force non può rimuovere un alias con una proprietà Option impostata su Constant.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome dell'alias da rimuovere.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Scope

Influisce solo sugli alias nell'ambito specificato. L'ambito predefinito è locale. Per altre informazioni, vedere about_Scopes.

I valori accettabili per questo parametro sono:

  • Global
  • Local
  • Script
  • Numero riferito all'ambito attuale (da 0 al numero di ambiti, dove 0 è l'ambito attuale e 1 è l'ambito padre)

Proprietà dei parametri

Tipo:String
Valore predefinito:Local
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

È possibile inviare tramite pipe un oggetto alias a questo cmdlet.

Output

None

Questo cmdlet non restituisce alcun output.

Note

Le modifiche influiscono solo sull'ambito corrente. Per rimuovere un alias da tutte le sessioni, aggiungere un comando Remove-Alias al profilo di PowerShell.

Per altre informazioni, vedere about_Aliases.