Get-Alias

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Pobiera aliasy dla bieżącej sesji.

Składnia

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

Opis

Polecenie Get-Alias cmdlet 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. Gdy używasz parametru Definicja , Get-Alias przyjmuje nazwę polecenia i zwraca jego aliasy.

Począwszy od programu Windows PowerShell 3.0, wyświetla nazwy aliasów innych Get-Alias niż łączniki w <alias> -> <definition> formacie, 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ą <alias> -> <definition> format 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 Get-ChildItem polecenia cmdlet.

Domyślnie Get-Alias polecenie cmdlet pobiera nazwę elementu, gdy znasz alias. Parametr Definicja 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 Opcje to ReadOnly. To polecenie zapewnia szybki sposób znajdowania aliasów wbudowanych w program PowerShell, ponieważ mają opcję ReadOnly .

Opcje to tylko jedna właściwość pobieranych Get-Alias obiektów AliasInfo. 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 Zakres , 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ę Definicja, ponieważ wyszukuje nazwę elementu we właściwości Definition obiektu aliasu.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Name

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

Type:String[]
Position:0
Default value:All aliases
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-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 jego elementem nadrzędnym)

Wartość domyślna to Local. Aby uzyskać więcej informacji, zobacz about_Scopes.

Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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 programu Get-Alias:

  • Wszystkie platformy:

    • gal

  • Aby utworzyć nowy alias, użyj polecenia Set-Alias lub New-Alias. Aby usunąć alias, użyj polecenia 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.