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

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:

  • Globální
  • Místní
  • Scénář
  • Čí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.

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

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