Get-Alias

Ruft die Aliase für die aktuelle Sitzung ab.

Syntax

Get-Alias [[-Name] <string[]>] [-Exclude <string[]>] [-Scope <string>] [<CommonParameters>]

Get-Alias [-Definition <string[]>] [-Exclude <string[]>] [-Scope <string>] [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Get-Alias" werden die Aliase (alternative Namen für Befehle und ausführbare Dateien) in der aktuellen Sitzung abgerufen. Hierzu zählen integrierte Aliase, Aliase, die Sie festgelegt oder importiert haben, und Aliase, die Sie dem Windows PowerShell-Profil hinzugefügt haben.

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

Parameter

-Definition <string[]>

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

Der Name dieses Parameters lautet "Definition", da der Parameter den Elementnamen in der Definition-Eigenschaft des Aliasobjekts sucht.

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

true

-Exclude <string[]>

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

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

-Name <string[]>

Gibt die abzurufenden Aliase an. Platzhalter sind zulässig. Mit Get-Alias werden standardmäßig alle für die aktuelle Sitzung definierten Aliase abgerufen. Der Parametername ("Name") ist optional. Sie können Aliasnamen auch über die Pipeline an Get-Alias übergeben.

Erforderlich?

false

Position?

1

Standardwert

Pipelineeingaben akzeptieren?

true (ByValue, ByPropertyName)

Platzhalterzeichen akzeptieren?

false

-Scope <string>

Ruft nur die Aliase im angegebenen Bereich ab. Gültige Werte sind "global", "local", "script", oder eine Zahl in Bezug auf den aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 der übergeordnete Bereich ist). Der Standardwert ist "local". Weitere Informationen finden Sie unter "about_Scopes".

Erforderlich?

false

Position?

named

Standardwert

Pipelineeingaben akzeptieren?

false

Platzhalterzeichen akzeptieren?

false

<CommonParameters>

Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.

Eingaben und Ausgaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.

Eingaben

System.String

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

Ausgaben

System.Management.Automation.AliasInfo

Get-Alias gibt ein Objekt zurück, das jeden Alias darstellt.

Hinweise

Aliase sind alternative Namen oder Kurzbezeichnungen für Cmdlets, Funktionen oder ausführbare Dateien. Um das Cmdlet, die Funktion oder die ausführbare Datei auszuführen, können Sie den vollständigen Namen oder einen beliebigen Alias verwenden. Weitere Informationen finden Sie unter "about_Aliases".

Um einen neuen Alias zu erstellen, verwenden Sie Set-Alias oder New-Alias. Um einen Alias zu löschen, verwenden Sie Remove-Item.

Beispiel 1

C:\PS>get-alias

Beschreibung
-----------
Mit diesem Befehl werden alle Aliase in der aktuellen Sitzung abgerufen.





Beispiel 2

C:\PS>get-alias -name g*, s* -exclude get-*

Beschreibung
-----------
Mit diesem Befehl werden alle Aliase abgerufen, die mit "g" oder "s" beginnen, mit Ausnahme von Aliasen, die mit "get-" beginnen.





Beispiel 3

C:\PS>get-alias -definition Get-ChildItem

Beschreibung
-----------
Mit diesem Befehl werden die Aliase für das Cmdlet "Get-ChildItem" abgerufen.

Standardmäßig ruft das Cmdlet "Get-Alias" den Elementnamen ab, wenn Sie den Alias kennen. Mit dem Definition-Parameter wird der Alias abgerufen, wenn Sie den Elementnamen kennen.





Beispiel 4

C:\PS>get-alias | where-object {$_.Options -match "ReadOnly"}

Beschreibung
-----------
Mit diesem Befehl werden alle Aliase abgerufen, deren Options-Eigenschaft den Wert "ReadOnly" aufweist. Dieser Befehl bietet eine schnelle Möglichkeit zum Suchen der in Windows PowerShell integrierten Aliase, weil diese über die Option "ReadOnly" verfügen.

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





Beispiel 5

C:\PS>get-alias -definition "*-pssession" -exclude e* -scope global

Beschreibung
-----------
In diesem Beispiel werden Aliase für Befehle abgerufen, deren Namen mit "-pssession" enden, mit Ausnahme von Namen, die mit "e" beginnen. 

Der Befehl wird mithilfe des Scope-Parameters im globalen Bereich angewendet. Dies ist in Skripts hilfreich, wenn Sie die Aliase in der Sitzung abrufen möchten.





Siehe auch

Konzepte

about_Aliases
Set-Alias
New-Alias
Export-Alias
Import-Alias
Alias Provider