Freigeben über

Remove-Alias

Modul:
Microsoft.PowerShell.Utility Module

Entfernen Sie einen Alias aus der aktuellen Sitzung.

Syntax

Default (Standardwert) 

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 Operator -ne (ungleich) wählt Objekte aus, für die kein Options-wert auf Konstanten-festgelegt ist. 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.

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