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. Pokud použijete parametr definice , 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 formátu <alias> -> <definition>, 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

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

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ž alias znáte. 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í.

Možnosti jsou pouze jednou vlastností objektů AliasInfo, které Get-Alias. 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:

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

Místní je výchozí hodnota. 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

Názvy aliasů můžete Get-Alias.

Výstupy

AliasInfo

Get-Alias vrátí objekt, který představuje jednotlivé aliasy. Get-Alias vrátí stejný objekt 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

  • Pokud chcete vytvořit nový alias, použijte Set-Alias nebo Nový 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í.