Sdílet prostřednictvím

Get-Alias

  • Reference
Modul:
Microsoft.PowerShell.Utility

Získá aliasy pro aktuální relaci.

Syntaxe

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

Description

Rutina Get-Alias získá aliasy v aktuální relaci. To zahrnuje předdefinované aliasy, aliasy, které jste nastavili nebo naimportovali, a aliasy, které jste přidali do profilu PowerShellu.

Ve výchozím nastavení Get-Alias přebírá alias a vrací název příkazu. Když použijete parametr Definition, Get-Alias vezme název příkazu a vrátí jeho aliasy.

Počínaje Windows PowerShellem 3.0 Get-Alias zobrazí názvy aliasů bez dělení slov v <alias> -> <definition> formátu, aby bylo ještě jednodušší najít potřebné informace.

Příklady

Příklad 1: Získání všech aliasů v aktuální relaci

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

Tento příkaz získá všechny aliasy v aktuální relaci.

Výstup ukazuje formát <alias> -> <definition>, který byl zaveden ve Windows PowerShellu 3.0. Tento formát se používá pouze pro aliasy, které neobsahují spojovníky, protože aliasy s pomlčkami jsou obvykle upřednostňovanými názvy rutin a funkcí, nikoli pro přezdívky.

Příklad 2: Získání aliasů podle názvu

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

Tento příkaz získá všechny aliasy, které začínají gp nebo sp, s výjimkou aliasů, které končí ps.

Příklad 3: Získání aliasů pro rutinu

Get-Alias -Definition Get-ChildItem

Tento příkaz získá aliasy pro rutinu Get-ChildItem.

Ve výchozím nastavení získá rutina Get-Alias název položky, když znáte alias. Parametr Definition získá alias, když znáte název položky.

Příklad 4: Získání aliasů podle vlastnosti

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

Tento příkaz získá všechny aliasy, ve kterých hodnota vlastnosti Options je ReadOnly. Tento příkaz nabízí rychlý způsob, jak najít aliasy, které jsou integrované v PowerShellu, protože mají možnost jen pro čtení.

Options je jen jedna vlastnost AliasInfo objekty, které Get-Alias získá. Chcete-li najít všechny vlastnosti a metody AliasInfo objekty, zadejte Get-Alias | Get-Member.

Příklad 5: Získání aliasů podle názvu a filtrování podle počátečního písmena

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

Tento příklad získá aliasy pro příkazy, které mají názvy, které končí na "-PSSession", s výjimkou těch, které začínají na "e".

Příkaz používá parametr Scope k použití příkazu v globálním oboru. To je užitečné ve skriptech, když chcete získat aliasy v relaci.

Parametry

-Definition

Získá aliasy pro zadanou položku. Zadejte název rutiny, funkce, skriptu, souboru nebo spustitelného souboru.

Tento parametr se nazývá Definice, protože vyhledá název položky ve vlastnosti Definice objektu aliasu.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-Exclude

Vynechá zadané položky. Hodnota tohoto parametru kvalifikuje parametry Name a Definition. Zadejte název, definici nebo vzor, například "s*". Jsou povoleny zástupné cardy.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-Name

Určuje aliasy, které tato rutina získá. Jsou povoleny zástupné cardy. Ve výchozím nastavení Get-Alias načte všechny aliasy definované pro aktuální relaci. Název parametru Název je volitelný. Aliasy můžete také zadávat do Get-Alias.

Typ:String[]
Position:0
Default value:All aliases
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-Scope

Určuje obor, pro který tato rutina získá aliasy. Přijatelné hodnoty pro tento parametr jsou:

  • Global
  • Local
  • Script
  • Číslo relativní k aktuálnímu oboru (0 až počet oborů, kde 0 je aktuální obor a 1 je jeho nadřazený)

Local je výchozí. Další informace najdete v tématu about_Scopes.

Typ:String
Position:Named
Default value:Local
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String

Do této rutiny můžete zamísit řetězec obsahující název aliasu.

Výstupy

AliasInfo

Tato rutina vrátí objekt, který představuje každý alias. Vrátí stejný typ objektu pro každý alias, ale PowerShell používá formát založený na šipkách k zobrazení názvů nemlčených aliasů.

Poznámky

Windows PowerShell obsahuje následující aliasy pro Get-Alias:

  • gal

  • Pokud chcete vytvořit nový alias, použijte Set-Alias nebo New-Alias. Pokud chcete odstranit alias, použijte Remove-Item.

  • Formát názvu aliasu založeného na šipkách se nepoužívá pro aliasy, které obsahují spojovník. Místo typických zkratek nebo přezdívek je pravděpodobně vhodnější nahradit názvy rutin a funkcí.