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. 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
  • Lokal
  • Skript
  • 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 Remove-Alias übergeben.

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

Weitere Informationen finden Sie unter about_Aliases.