Share via

Remove-Alias

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Entfernen Sie einen Alias aus der aktuellen Sitzung.

Syntax

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

Beschreibung

Das Remove-Alias Cmdlet entfernt einen Alias aus der aktuellen PowerShell-Sitzung. Verwenden Sie den Force-Parameter, um einen Alias zu entfernen, bei dem die Option-Eigenschaft auf ReadOnly festgelegt ist.

Das Remove-Alias-Cmdlet wurde in PowerShell 6.0 eingeführt.

Beispiele

Beispiel 1: Entfernen eines Alias

In diesem Beispiel wird ein Alias namens del entfernt, der das Remove-Item Cmdlet darstellt.

Remove-Alias -Name del

Beispiel 2: Entfernen aller nicht konstanten Aliase

In diesem Beispiel werden alle Aliase aus der aktuellen PowerShell-Sitzung entfernt, mit Ausnahme von Aliasen, deren Options-Eigenschaft auf Konstant festgelegt ist. Nachdem der Befehl ausgeführt wurde, sind die Aliase in anderen PowerShell-Sitzungen oder neuen PowerShell-Sitzungen verfügbar.

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

Get-Alias ruft alle Aliase in der PowerShell-Sitzung ab und sendet die Objekte nach unten in der Pipeline. Where-Object verwendet einen Skriptblock, und die automatische Variable ($_) und die Options-Eigenschaft stellen das aktuelle Pipelineobjekt dar. Der Parameter NE (ungleich) wählt Objekte aus, für die kein Optionswert auf Konstant festgelegt ist. Remove-Alias verwendet den Force-Parameter , um Aliase, einschließlich schreibgeschützter Aliase, aus der PowerShell-Sitzung zu entfernen. Der Force-Parameter kann keine Konstantenaliasen entfernen.

Parameter

-Force

Gibt an, dass das Cmdlet einen Alias entfernt, einschließlich Aliasen, deren Option-Eigenschaft auf ReadOnly festgelegt ist. Der Force-Parameter kann keinen Alias entfernen, bei dem die Option-Eigenschaft auf Constant festgelegt ist.

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

-Name

Gibt den Namen des zu entfernenden Alias an.

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

-Scope

Wirkt sich nur auf die Aliase im angegebenen Bereich aus. Der Standardbereich ist Lokal. Weitere Informationen finden Sie unter about_Scopes.

Zulässige Werte für diesen Parameter:

  • Global
  • Local
  • Script
  • Eine Zahl relativ zum aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 sein übergeordnetes Element ist)
Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String[]

Sie können ein Aliasobjekt an dieses Cmdlet übergeben.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Änderungen wirken sich nur auf den aktuellen Bereich aus. Um einen Alias aus allen Sitzungen zu entfernen, fügen Sie Ihrem PowerShell-Profil einen Befehl hinzu Remove-Alias .

Weitere Informationen finden Sie unter about_Aliases.