Remove-Alias

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Rimuovere un alias dalla sessione corrente.

Sintassi

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

Descrizione

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

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

Esempio

Esempio 1 - Rimuovere un alias

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

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à Options impostata su Constant. 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 la proprietà Options rappresentano l'oggetto pipeline corrente. Il parametro NE (diverso da uguale), seleziona gli oggetti che non hanno 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 costanti .

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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica il nome dell'alias da rimuovere.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Scope

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

I valori validi 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)
Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String[]

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

Output

None

Questo cmdlet non restituisce output.

Note

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

Per altre informazioni, vedere about_Aliases.