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 cmdlet Remove-Alias 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 Parameter Force.

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

Beispiele

Beispiel 1 : Entfernen eines Alias

In diesem Beispiel wird ein Alias namens del entfernt, der das cmdlet Remove-Item 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 mit der Options-Eigenschaft, die auf Konstanten-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- (ungleich) wählt Objekte aus, die keinen Options-wert auf Konstanten-festgelegt haben. Remove-Alias verwendet den Parameter Force zum Entfernen von Aliasen, einschließlich schreibgeschützter Aliase, aus der PowerShell-Sitzung. Der Parameter Force kann Konstanten- Aliase nicht entfernen.

Parameter

-Force

Gibt an, dass das Cmdlet einen Alias entfernt, einschließlich Aliase mit der eigenschaft Option auf ReadOnlyfestgelegt ist. Der Parameter Force kann einen Alias nicht entfernen, wobei eine Option-Eigenschaft auf Konstanten-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 lokalen. Weitere Informationen finden Sie unter about_Scopes.

Die zulässigen Werte für diesen Parameter sind:

  • 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.