Condividi tramite

Remove-Alias

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Rimuovere un alias dalla sessione corrente.

Sintassi

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, usare 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 nella pipeline. Where-Object usa un blocco di script e la variabile automatica ($_) e Options proprietà rappresentano l'oggetto pipeline corrente. Il parametro NE (non uguale), seleziona gli oggetti che non dispongono di un valore Options impostato su Constant. 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à option impostata su ReadOnly. Il parametro Force non può rimuovere un alias con una proprietà Option impostata su Constant.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome dell'alias da rimuovere.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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 relativo all'ambito corrente (da 0 al numero di ambiti, dove 0 è l'ambito corrente e 1 è il relativo elemento padre)
Tipo:String
Posizione:Named
Valore predefinito:Local
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

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.