Udostępnij za pomocą

Get-Alias

Moduł:
Microsoft.PowerShell.Utility Module

Pobiera aliasy dla bieżącej sesji.

Składnia

Default (Domyślna) 

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

Definition 

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

Opis

Polecenie cmdlet Get-Alias pobiera aliasy w bieżącej sesji. Obejmuje to wbudowane aliasy, aliasy, które zostały ustawione lub zaimportowane, oraz aliasy dodane do profilu programu PowerShell.

Domyślnie Get-Alias przyjmuje alias i zwraca nazwę polecenia. Jeśli używasz parametru definicji, Get-Alias przyjmuje nazwę polecenia i zwraca jego aliasy.

Począwszy od programu Windows PowerShell 3.0, Get-Alias wyświetla nazwy aliasów innych niż łączniki w formacie <alias> -> <definition>, aby jeszcze łatwiej znaleźć potrzebne informacje.

Przykłady

Przykład 1. Pobieranie wszystkich aliasów w bieżącej sesji

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

To polecenie pobiera wszystkie aliasy w bieżącej sesji.

Dane wyjściowe zawierają format <alias> -> <definition> wprowadzony w programie Windows PowerShell 3.0. Ten format jest używany tylko w przypadku aliasów, które nie zawierają łączników, ponieważ aliasy z łącznikami są zazwyczaj preferowanymi nazwami poleceń cmdlet i funkcji, a nie pseudonimami.

Przykład 2. Uzyskiwanie aliasów według nazwy

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

To polecenie pobiera wszystkie aliasy rozpoczynające się od gp lub sp, z wyjątkiem aliasów, które kończą się ps.

Przykład 3. Uzyskiwanie aliasów dla polecenia cmdlet

Get-Alias -Definition Get-ChildItem

To polecenie pobiera aliasy dla polecenia cmdlet Get-ChildItem.

Domyślnie polecenie cmdlet Get-Alias pobiera nazwę elementu, gdy znasz alias. Parametr Definition pobiera alias, gdy znasz nazwę elementu.

Przykład 4. Pobieranie aliasów według właściwości

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

To polecenie pobiera wszystkie aliasy, w których wartość właściwości Options jest ReadOnly. To polecenie zapewnia szybki sposób znajdowania aliasów wbudowanych w program PowerShell, ponieważ mają one opcję ReadOnly.

Options jest tylko jedną właściwością AliasInfo pobieranych obiektów Get-Alias. Aby znaleźć wszystkie właściwości i metody obiektów AliasInfo, wpisz Get-Alias | Get-Member.

Przykład 5. Uzyskiwanie aliasów według nazwy i filtrowania według litery początkowej

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

Ten przykład pobiera aliasy dla poleceń, które mają nazwy kończące się ciągiem "-PSSession", z wyjątkiem tych, które zaczynają się od "e".

Polecenie używa parametru Scope, aby zastosować polecenie w zakresie globalnym. Jest to przydatne w skryptach, gdy chcesz uzyskać aliasy w sesji.

Parametry

-Definition

Pobiera aliasy dla określonego elementu. Wprowadź nazwę polecenia cmdlet, funkcji, skryptu, pliku lub pliku wykonywalnego.

Ten parametr nosi nazwę Definition, ponieważ wyszukuje nazwę elementu we właściwości Definition obiektu aliasu.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

Definition
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Exclude

Pomija określone elementy. Wartość tego parametru kwalifikuje parametry name i Definition. Wprowadź nazwę, definicję lub wzorzec, taki jak "s*". Symbole wieloznaczne są dozwolone.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Określa aliasy, które pobiera to polecenie cmdlet. Symbole wieloznaczne są dozwolone. Domyślnie Get-Alias pobiera wszystkie aliasy zdefiniowane dla bieżącej sesji. Nazwa parametru Nazwa jest opcjonalna. Możesz również potokować nazwy aliasów, aby Get-Alias.

Właściwości parametru

Typ:

String[]

Domyślna wartość:All aliases
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

Default
Position:0
Obowiązkowy:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Scope

Określa zakres, dla którego to polecenie cmdlet pobiera aliasy. Dopuszczalne wartości tego parametru to:

  • Global
  • Local
  • Script
  • Liczba względem bieżącego zakresu (od 0 do liczby zakresów, gdzie 0 jest bieżącym zakresem, a 1 jest zakresem nadrzędnym)

Local jest wartością domyślną. Aby uzyskać więcej informacji, zobacz about_Scopes.

Właściwości parametru

Typ:String
Domyślna wartość:Local
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

Możesz potokować ciąg zawierający nazwę aliasu do tego polecenia cmdlet.

Dane wyjściowe

AliasInfo

To polecenie cmdlet zwraca obiekt reprezentujący każdy alias. Zwraca on ten sam typ obiektu dla każdego aliasu, ale program PowerShell używa formatu opartego na strzałkach do wyświetlania nazw aliasów bez dzielenia wyrazów.

Uwagi

Program PowerShell zawiera następujące aliasy dla Get-Alias:

  • Wszystkie platformy:

    • gal

  • Aby utworzyć nowy alias, użyj Set-Alias lub New-Alias. Aby usunąć alias, użyj Remove-Item.

  • Format nazwy aliasu opartego na strzałce nie jest używany w przypadku aliasów zawierających łącznik. Prawdopodobnie będą to preferowane nazwy zastępcze poleceń cmdlet i funkcji, zamiast typowych skrótów lub pseudonimów.