Get-Alias
Ruft die Aliase für die aktuelle Sitzung ab.
Syntax
Default (Standard)
Get-Alias
[[-Name] <String[]>]
[-Exclude <String[]>]
[-Scope <String>]
[<CommonParameters>]
Definition
Get-Alias
[-Exclude <String[]>]
[-Scope <String>]
[-Definition <String[]>]
[<CommonParameters>]
Beschreibung
Das Cmdlet Get-Alias ruft die Aliase in der aktuellen Sitzung ab. Dazu gehören integrierte Aliase, Aliase, die Sie festgelegt oder importiert haben, sowie Aliase, die Sie Ihrem PowerShell-Profil hinzugefügt haben.
Standardmäßig verwendet Get-Alias einen Alias und gibt den Befehlsnamen zurück. Wenn Sie den Definition-Parameter verwenden, verwendet Get-Alias einen Befehlsnamen und gibt dessen Aliase zurück.
Ab Windows PowerShell 3.0 zeigt Get-Alias Aliasnamen ohne Bindestrich in einem <alias> -> <definition> Format an, das das Auffinden der benötigten Informationen noch einfacher macht.
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 an, das in Windows PowerShell 3.0 eingeführt wurde.
Dieses Format wird nur für Aliase verwendet, die keine Bindestriche enthalten, da Aliase mit Bindestrichen in der Regel bevorzugte Namen für Cmdlets und Funktionen und nicht für Spitznamen sind.
Beispiel 2: Abrufen von Aliasen nach Name
Get-Alias -Name gp*, sp* -Exclude *ps
Dieser Befehl ruft alle Aliase ab, die mit gp oder sp beginnen, mit Ausnahme von Aliasen, die mit ps enden.
Beispiel 3: Abrufen von Aliasen für ein Cmdlet
Get-Alias -Definition Get-ChildItem
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. Der parameter Definition ruft den Alias ab, wenn Sie den Elementnamen kennen.
Beispiel 4: Abrufen von Aliasen nach Eigenschaft
Get-Alias | Where-Object {$_.Options -Match "ReadOnly"}
Mit diesem Befehl werden alle Aliase abgerufen, bei 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 Get-Alias | get-member.
Beispiel 5: Abrufen von Aliasen nach Name und Filter nach Anfangsbuchstaben
Get-Alias -Definition "*-PSSession" -Exclude e* -Scope Global
In diesem Beispiel werden Aliase für Befehle mit Namen, die in "-PSSession" enden, mit Ausnahme von Aliasen, die mit "e" beginnen.
Der Befehl verwendet den parameter Scope, um den Befehl im globalen Bereich anzuwenden. Dies ist in Skripts nützlich, 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 wird Definitionaufgerufen, da er in der Definition-Eigenschaft des Aliasobjekts nach dem Elementnamen sucht.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
Definition
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Exclude
Lässt die angegebenen Elemente aus. Der Wert dieses Parameters qualifiziert die Parameter Name und Definition. Geben Sie einen Namen, eine Definition oder ein Muster ein, z. B. "s*". Wildcards sind zulässig.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| 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 die Aliase an, die dieses Cmdlet abruft.
Wildcards sind zulässig.
Standardmäßig ruft Get-Alias alle für die aktuelle Sitzung definierten Aliase ab.
Der Parametername Name ist optional.
Sie können auch Aliasnamen an Get-Aliaspipen.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | All aliases |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
Default
| Position: | 0 |
| Obligatorisch: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Scope
Gibt den Bereich an, für den dieses Cmdlet Aliase abruft. Die zulässigen Werte für diesen Parameter sind:
- Weltweit
- Lokal
- Skript
- Eine Zahl relativ zum aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich ist und 1 das übergeordnete Element ist)
Lokal ist die Standardeinstellung. Weitere Informationen finden Sie unter about_Scopes.
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 Aliasnamen über die Pipeline an Get-Alias übergeben.
Ausgaben
AliasInfo
Get-Alias gibt ein Objekt zurück, das jeden Alias darstellt. Get-Alias gibt für jeden Alias dasselbe Objekt zurück, aber PowerShell verwendet ein pfeilbasiertes Format, um die Namen von Aliasen ohne Bindestrich anzuzeigen.
Hinweise
- Verwenden Sie Set-Alias oder "New-Alias", um einen neuen Alias zu erstellen. Verwenden Sie "Remove-Item", um einen Alias zu löschen.
- Das pfeilbasierte Aliasnamenformat wird nicht für Aliase verwendet, die einen Bindestrich enthalten. Dies sind wahrscheinlich bevorzugte Ersatznamen für Cmdlets und Funktionen anstelle typischer Abkürzungen oder Spitznamen.