Freigeben über

Get-Alias

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Ruft die Aliase für die aktuelle Sitzung ab.

Syntax

Get-Alias
   [[-Name] <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]
Get-Alias
   [-Exclude <String[]>]
   [-Scope <String>]
   [-Definition <String[]>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-Alias ruft die Aliase in der aktuellen Sitzung ab. Dies umfasst integrierte Aliase, Aliase, die Sie festgelegt oder importiert haben, und Aliase, die Sie Ihrem PowerShell-Profil hinzugefügt haben.

Standardmäßig nimmt Get-Alias einen Alias an und gibt den Befehlsnamen zurück. Wenn Sie den Definition-Parameter verwenden, nimmt Get-Alias einen Befehlsnamen an und gibt dessen Aliase zurück.

Ab Windows PowerShell 3.0 zeigt Get-Alias namen ohne Silbentrennung in einem <alias> -> <definition> Format an, um das Auffinden der benötigten Informationen noch einfacher zu machen.

Beispiele

Beispiel 1: Abrufen aller Aliase in der aktuellen Sitzung

PS C:\> Get-Alias

CommandType     Name
-----------     ----
Alias           % -> ForEach-Object
Alias           ? -> Where-Object
Alias           ac -> Add-Content
Alias           asnp -> Add-PSSnapin
Alias           cat -> Get-Content
Alias           cd -> Set-Location
Alias           chdir -> Set-Location
Alias           clc -> Clear-Content
Alias           clear -> Clear-Host
Alias           clhy -> Clear-History
...

Dieser Befehl ruft alle Aliase in der aktuellen Sitzung ab.

Die Ausgabe zeigt das <alias> -> <definition> Format, das in Windows PowerShell 3.0 eingeführt wurde. Dieses Format wird nur für Aliase verwendet, die keine Bindestriche enthalten, weil Aliase mit Bindestrichen in der Regel bevorzugte Namen für Cmdlets und Funktionen und keine Spitznamen sind.

Beispiel 2: Abrufen von Aliasen nach Namen

Get-Alias -Name gp*, sp* -Exclude *ps

Dieser Befehl ruft alle Aliase ab, die mit gp oder sp beginnen, mit Ausnahme von Aliasen, die auf ps enden.

Beispiel 3: Abrufen von Aliasen für ein Cmdlet

Get-Alias -Definition Get-ChildItem

Dieser Befehl ruft die Aliase für das Get-ChildItem-Cmdlet ab.

Standardmäßig ruft das Cmdlet Get-Alias den Elementnamen ab, wenn Sie den Alias kennen. Der Definition-Parameter ruft den Alias ab, wenn Sie den Elementnamen kennen.

Beispiel 4: Abrufen von Aliasen nach Eigenschaft

Get-Alias | Where-Object {$_.Options -Match "ReadOnly"}

Dieser Befehl ruft alle Aliase ab, in denen der Wert der Options-Eigenschaft ReadOnly ist. Dieser Befehl bietet eine schnelle Möglichkeit, die in PowerShell integrierten Aliase zu finden, da sie über die Option ReadOnly verfügen.

Options ist nur eine Eigenschaft der AliasInfo-Objekte, die Get-Alias abruft. Um alle Eigenschaften und Methoden von AliasInfo-Objekten zu suchen, geben Sie ein Get-Alias | get-member.

Beispiel 5: Abrufen von Aliasen nach Name und Filtern nach Anfangsbuchstaben

Get-Alias -Definition "*-PSSession" -Exclude e* -Scope Global

In diesem Beispiel werden Aliase für Befehle abgerufen, deren Namen mit „-PSSession“ enden, mit Ausnahme der Aliase, die mit „e“ beginnen.

Der Befehl verwendet den Scope-Parameter , um den Befehl im globalen Bereich anzuwenden. Dies empfiehlt sich in Skripts, wenn Sie die Aliase in der Sitzung abrufen möchten.

Parameter

-Definition

Ruft die Aliase für das angegebene Element ab. Geben Sie den Namen eines Cmdlets, einer Funktion, eines Skripts, einer Datei oder einer ausführbaren Datei ein.

Dieser Parameter heißt Definition, da er in der Definition-Eigenschaft des Aliasobjekts nach dem Elementnamen sucht.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

Lässt die angegebenen Elemente aus. Der Wert dieses Parameters qualifiziert die Name- und Definition-Parameter. Geben Sie einen Namen, eine Definition oder ein Muster wie z. B. „s*“ ein. Platzhalter sind zulässig.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Name

Gibt die Aliase an, die dieses Cmdlet abruft. Platzhalter sind zulässig. Standardmäßig werden alle Aliase abgerufen, Get-Alias die für die aktuelle Sitzung definiert sind. Der Parametername Name ist optional. Sie können auch Aliasnamen an übergeben Get-Alias.

Type:String[]
Position:0
Default value:All aliases
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Scope

Gibt den Bereich an, für den dieses Cmdlet Aliase abruft. Zulässige Werte für diesen Parameter:

  • Global
  • Lokal
  • Skript
  • Eine Zahl relativ zum aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 sein übergeordnetes Element ist)

Lokal ist die Standardeinstellung. Weitere Informationen finden Sie unter „about_Scopes“.

Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

Sie können Aliasnamen an Get-Alias übergeben.

Ausgaben

AliasInfo

Get-Alias gibt ein Objekt zurück, das jeden Alias darstellt. Get-Alias gibt für jeden Alias das gleiche Objekt zurück, aber PowerShell verwendet ein pfeilbasiertes Format, um die Namen von nicht bindestrichenen Aliasen anzuzeigen.

Hinweise

  • Um einen neuen Alias zu erstellen, verwenden Sie Set-Alias oder New-Alias. Verwenden Sie zum Löschen eines Alias Remove-Item.
  • Das pfeilbasierte Aliasnamensformat wird nicht für Aliase verwendet, die einen Bindestrich enthalten. Dabei handelt es sich wahrscheinlich um bevorzugte Ersatznamen für Cmdlets und Funktionen anstelle der üblichen Abkürzungen und Spitznamen.