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. Um einen Alias zu entfernen, bei dem die Option-Eigenschaft auf ReadOnly festgelegt ist, verwenden Sie den Force-Parameter .

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

Beispiele

Beispiel 1: Entfernen eines Alias

In diesem Beispiel wird ein Alias mit dem Namen 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 Optionseigenschaft 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 über die Pipeline. Where-Object verwendet einen Skriptblock, und die automatische Variable ($_) und die Options-Eigenschaft stellen das aktuelle Pipelineobjekt dar. Der Parameter NE (nicht gleich) 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.

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 Konstant 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 Local. Weitere Informationen finden Sie unter about_Scopes.

Zulässige Werte für diesen Parameter:

  • Global
  • Local
  • Script
  • Eine Zahl relativ zum aktuellen Bereich (0 durch die Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 sein übergeordneter Bereich 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 übergeben Remove-Alias.

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.