Sdílet prostřednictvím

Get-Alias

Modul:
Microsoft.PowerShell.Utility Module

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

Syntax

Default (Výchozí) 

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

Definition 

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.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

Definition
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

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

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

Určuje aliasy, které tato rutina získá. Jsou povoleny zástupné symboly. 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.

Vlastnosti parametru

Typ:

String[]

Default value:All aliases
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

Default
Position:0
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-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 části about_Scopes.

Vlastnosti parametru

Typ:String
Default value:Local
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

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