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 ve <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 <alias> -> <definition> formát, 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í rutina Get-Alias získá 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 je hodnota Options vlastnost 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 pouze jedna vlastnost Objekty AliasInfo , které Get-Alias se načte. 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žije 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á Definition, protože hledá název položky ve vlastnosti Definition objektu alias.

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 je volitelný. Aliasy můžete také generovat na 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. Tento parametr přijímá tyto hodnoty:

  • 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í možnost. 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

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

  • Všechny platformy:

    • gal

  • Chcete-li 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í.