Freigeben über

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 Parameter Force, 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 entfernt del , 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, bei denen die 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 an die Pipeline. Where-Object verwendet einen Skriptblock, und die automatische Variable ($_) und Options-Eigenschaft stellen das aktuelle Pipelineobjekt dar. Der Parameter NE (nicht gleich) markiert Objekte, für die kein Optionswert auf "Konstant" festgelegt ist. Remove-Alias verwendet den Parameter Force , um Aliase, einschließlich schreibgeschützter Aliase, aus der PowerShell-Sitzung zu entfernen. Der Parameter Force kann konstanten Aliase nicht entfernen.

Parameter

-Force

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

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen des zu entfernenden Alias an.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Scope

Betrifft nur die Aliase im angegebenen Bereich. 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 ist und 1 das übergeordnete Element ist)
Typ:String
Position:Named
Standardwert:Local
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String[]

Sie können ein Aliasobjekt an dieses Cmdlet weiterleiten.

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 Remove-Alias Befehl hinzu.

Weitere Informationen finden Sie unter about_Aliases.