Get-Alias
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 Get-Alias
Cmdlet ruft die Aliase in der aktuellen Sitzung ab. Dazu gehören integrierte Aliase, Aliase, die Sie festgelegt oder importiert haben, und Aliase, die Sie Ihrem PowerShell-Profil hinzugefügt haben.
Nimmt standardmäßig einen Alias an und Get-Alias
gibt den Befehlsnamen zurück. Wenn Sie den Definition-Parameter verwenden, Get-Alias
nimmt einen Befehlsnamen an und gibt seine Aliase zurück.
Ab Windows PowerShell 3.0 werden Aliasnamen ohne Bindestriche in einem <alias> -> <definition>
Format angezeigt, Get-Alias
um das Auffinden der benötigten Informationen noch einfacher zu machen.
Beispiele
Beispiel 1: Abrufen aller Aliase in der aktuellen Sitzung
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 Name
Get-Alias -Name gp*, sp* -Exclude *ps
Mit diesem Befehl werden alle Aliase abgerufen, 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 Get-ChildItem
Cmdlet abgerufen.
Standardmäßig ruft das Get-Alias
Cmdlet 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"}
Mit diesem Befehl werden alle Aliase abgerufen, in denen der Wert der Options-EigenschaftReadOnly 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
abgerufen werden. Geben Sie einGet-Alias | get-member
, um alle Eigenschaften und Methoden von AliasInfo-Objekten zu suchen.
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 wird Definition genannt, 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 Parameter Name und Definition . 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. Ruft standardmäßig alle aliase ab, Get-Alias
die für die aktuelle Sitzung definiert sind. Der Parametername Name ist optional. Sie können aliasnamen auch 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 erhält. Zulässige Werte für diesen Parameter:
Global
Local
Script
- Eine Zahl relativ zum aktuellen Bereich (0 durch die Anzahl der Bereiche, wobei 0 der aktuelle Bereich und 1 sein übergeordneter Bereich ist)
Local
ist die Standardoption. 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
Sie können Aliasnamen an übergeben Get-Alias
.
Ausgaben
Get-Alias
gibt ein Objekt zurück, das jeden Alias darstellt. Get-Alias
gibt das gleiche Objekt für jeden Alias zurück, aber PowerShell verwendet ein pfeilbasiertes Format, um die Namen nicht bindegebinder Aliase anzuzeigen.
Hinweise
- Verwenden Sie
Set-Alias
oderNew-Alias
, um einen neuen Alias zu erstellen. Um einen Alias zu löschen, verwenden SieRemove-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.