Get-Alias

Modul:
Microsoft.PowerShell.Utility Module

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 Get-Alias Cmdlet 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.

Akzeptiert standardmäßig Get-Alias einen Alias und gibt den Befehlsnamen zurück. Wenn Sie den Definition-Parameter verwenden, Get-Alias wird ein Befehlsname verwendet und dessen Aliase zurückgegeben.

Ab Windows PowerShell 3.0 zeigt Get-Alias nicht silbenierte Aliasnamen in einem format <alias> -> <definition> an, damit die benötigten Informationen noch einfacher zu finden sind.

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 format <alias> -> <definition> 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

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

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"}

Dieser Befehl ruft alle Aliase ab, in denen der Wert der Options-EigenschaftReadOnly lautet. 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 sie abrufen. Geben Sie ein, um alle Eigenschaften und Methoden von Get-Alias | Get-Member zu finden.

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 als Definition bezeichnet, 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. Ruft standardmäßig Get-Alias alle für die aktuelle Sitzung definierten Aliase ab. Der Parametername ist optional. Sie können aliasnamen Get-Aliasauch an .

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:

  • Global
  • Local
  • Script
  • Eine Zahl relativ zum aktuellen Bereich (0 bis zur Anzahl der Bereiche, wobei 0 der aktuelle Bereich ist und 1 das übergeordnete Element ist)

Local ist die Standardoption. 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 eine Zeichenfolge mit einem Aliasnamen an dieses Cmdlet weiterleiten.

Ausgaben

AliasInfo

Dieses Cmdlet gibt ein Objekt zurück, das jeden Alias darstellt. Es gibt denselben Objekttyp für jeden Alias zurück, aber PowerShell verwendet ein pfeilbasiertes Format, um die Namen von nicht silbenierten Aliasen anzuzeigen.

Hinweise

PowerShell enthält die folgenden Aliase für Get-Alias:

  • Alle Plattformen:

    • gal

  • Um einen neuen Alias zu erstellen, verwenden Set-Alias oder New-Alias. Verwenden Sie Remove-Itemzum Löschen eines Alias .

  • 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.