Udostępnij za pośrednictwem

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 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 Definition, Get-Alias przyjmuje nazwę polecenia i zwraca jego aliasy.

Począwszy od programu Windows PowerShell 3.0, get-alias wyświetla nazwy aliasów bez dzielenia wyrazów w formacie <alias> -> <definition>, aby jeszcze łatwiej znaleźć potrzebne informacje.

Przykłady

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

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

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 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ść obiektów AliasInfo, które get-alias pobiera. 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.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 Nazwa jest opcjonalna. Możesz również potokować nazwy aliasów, aby Get-Alias.

Typ:String[]
Position:0
Domyślna wartość:All aliases
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-Scope

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

  • Globalny
  • Lokalny
  • Skrypt
  • 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ść lokalna to wartość domyślna. Aby uzyskać więcej informacji, zobacz about_Scopes.

Typ:String
Position:Named
Domyślna wartość:Local
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Nazwy aliasów można potokować do Get-Alias.

Dane wyjściowe

AliasInfo

Get-Alias zwraca obiekt reprezentujący każdy alias. get-alias zwraca ten sam obiekt 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

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