Freigeben über

Remove-Alias

Modul:
Microsoft.PowerShell.Utility Module

Entfernen Sie einen Alias aus der aktuellen Sitzung.

Syntax

Default (Standard) 

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.

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.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen des zu entfernenden Alias an.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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)

Parametereigenschaften

Typ:String
Standardwert:Local
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

Sie können ein Aliasobjekt über die Pipeline an 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 Remove-Alias Befehl hinzu.

Weitere Informationen finden Sie unter about_Aliases.