Share via

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 Windows PowerShell 3.0, wyświetla nazwy aliasów bez Get-Alias dzielenia wyrazów 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 pokazują <alias> -> <definition> format wprowadzony w 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 polecenie cmdlet pobiera nazwę elementu, Get-Alias 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 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 jest nazywany definicją, 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 dla 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ć nazwy aliasów 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łce 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.