Set-Alias

Modul:

Microsoft.PowerShell.Utility

Vytvoří nebo změní alias pro rutinu nebo jiný příkaz v aktuální relaci PowerShellu.

Syntax

Set-Alias
   [-Name] <string>
   [-Value] <string>
   [-Description <string>]
   [-Option <ScopedItemOptions>]
   [-PassThru]
   [-Scope <string>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina Set-Alias vytvoří nebo změní alias pro rutinu nebo příkaz, například funkci, skript, soubor nebo jiný spustitelný soubor. Alias je alternativní název, který odkazuje na rutinu nebo příkaz. Je například sal alias rutiny Set-Alias . Další informace najdete v tématu about_Aliases.

Rutina může mít více aliasů, ale alias může být přidružený pouze k jedné rutině. Můžete použít Set-Alias k opětovnému přiřazení existujícího aliasu k jiné rutině nebo ke změně vlastností aliasu, například popisu.

Alias vytvořený nebo změněný uživatelem Set-Alias není trvalý a je k dispozici pouze během aktuální relace PowerShellu. Po zavření relace PowerShellu se alias odebere.

Příklady

Příklad 1: Create aliasu pro rutinu

Tento příkaz vytvoří alias rutiny v aktuální relaci PowerShellu.

PS> Set-Alias -Name list -Value Get-ChildItem

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

Rutina Set-Alias vytvoří alias v aktuální relaci PowerShellu. Parametr Name určuje název listaliasu . Parametr Value určuje rutinu, kterou alias spustí.

Pokud chcete alias spustit, zadejte list na příkazovém řádku PowerShellu.

Příklad 2: Opětovné přiřazení existujícího aliasu k jiné rutině

Tento příkaz znovu přiřazuje existující alias ke spuštění jiné rutiny.

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

PS> Set-Alias -Name list -Value Get-Location

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-Location

Rutina Get-Alias používá k zobrazení list aliasu parametr Name. Alias list je přidružený k rutině Get-ChildItem . Při spuštění aliasu list se zobrazí položky v aktuálním adresáři.

Rutina Set-Alias používá parametr Name k určení aliasu list . Parametr Value přidruží alias k rutině Get-Location .

Rutina Get-Alias používá k zobrazení list aliasu parametr Name. Alias list je přidružený k rutině Get-Location . Při spuštění aliasu list se zobrazí umístění aktuálního adresáře.

Příklad 3: Create a změna aliasu jen pro čtení

Tento příkaz vytvoří alias jen pro čtení. Možnost jen pro čtení zabraňuje nezamýšleným změnám aliasu. Pokud chcete změnit nebo odstranit alias jen pro čtení, použijte parametr Force .

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -PassThru | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         :
Name                : loc
CommandType         : Alias

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -Description 'Displays the current directory' -Force -PassThru | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         : Displays the current directory
Name                : loc
CommandType         : Alias

Rutina Set-Alias vytvoří alias v aktuální relaci PowerShellu. Parametr Name určuje název localiasu . Parametr Value určuje rutinu Get-Location , kterou alias spustí. Parametr Option určuje hodnotu ReadOnly . Parametr PassThru představuje objekt aliasu a odešle objekt do kanálu do rutiny Format-List . Format-List použije parametr Property s hvězdičkou (*), aby se zobrazily všechny vlastnosti. Ukázkový výstup ukazuje částečný seznam těchto vlastností.

Alias loc se změní přidáním dvou parametrů. Popis přidá text, který vysvětluje účel aliasu. Parametr Force je potřeba, protože loc alias je jen pro čtení. Pokud se parametr Force nepoužije, změna se nezdaří.

Příklad 4: Create aliasu ke spustitelnému souboru

Tento příklad vytvoří alias spustitelného souboru v místním počítači.

PS> Set-Alias -Name np -Value C:\Windows\notepad.exe

PS> Get-Alias -Name np

CommandType     Name
-----------     ----
Alias           np -> notepad.exe

Rutina Set-Alias vytvoří alias v aktuální relaci PowerShellu. Parametr Name určuje název npaliasu . Parametr Value určuje cestu a název aplikace C:\Windows\notepad.exe. Rutina Get-Alias pomocí parametru Name ukazuje, že np alias je přidružený knotepad.exe.

Pokud chcete alias spustit, zadejte np na příkazovém řádku PowerShellu notepad.exe.

Příklad 5: Create alias příkazu s parametry

Tento příklad ukazuje, jak přiřadit alias příkazu s parametry.

Můžete vytvořit alias pro rutinu, například Set-Location. Nelze vytvořit alias pro příkaz s parametry a hodnotami, například Set-Location -Path C:\Windows\System32. Pokud chcete vytvořit alias pro příkaz, vytvořte funkci, která příkaz obsahuje, a pak vytvořte alias pro funkci. Další informace najdete v tématu about_Functions.

PS> Function CD32 {Set-Location -Path C:\Windows\System32}

PS> Set-Alias -Name Go -Value CD32

Vytvoří se funkce s názvem CD32 . Funkce použije rutinu Set-Location s parametrem Path k určení adresáře C:\Windows\System32.

Rutina Set-Alias vytvoří alias funkce v aktuální relaci PowerShellu. Parametr Name určuje název Goaliasu . Parametr Value určuje název CD32funkce .

Pokud chcete alias spustit, zadejte Go na příkazovém řádku PowerShellu. Funkce se CD32 spustí a změní na adresář C:\Windows\System32.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Určuje popis aliasu. Můžete zadat libovolný řetězec. Pokud popis obsahuje mezery, uzavřete je jednoduchými uvozovkami.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Pomocí parametru Force změňte nebo odstraňte alias, který má parametr Option nastavený na Jen pro čtení.

Parametr Force nemůže změnit nebo odstranit alias s parametrem Option nastaveným na Konstantní.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Určuje název nového aliasu. Název aliasu může obsahovat alfanumerické znaky. Názvy aliasů nemohou být číselné, například 123.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Option

Nastaví hodnotu vlastnosti Option aliasu. Hodnoty jako ReadOnly a Constant chrání alias před nezamýšlenými změnami. Pokud chcete zobrazit vlastnost Option všech aliasů v relaci, zadejte Get-Alias | Format-Table -Property Name, Options -Autosize.

Přijatelné hodnoty pro tento parametr jsou následující:

• AllScope Alias se zkopíruje do všech nově vytvořených oborů.
• Konstantní Nelze změnit ani odstranit.
• Žádný Nenastaví žádné možnosti a je výchozí.
• Soukromé Alias je k dispozici pouze v aktuálním oboru.
• Readonly Nelze změnit ani odstranit, pokud není použit parametr Force .
• Unspecified

Type:	ScopedItemOptions
Accepted values:	AllScope, Constant, None, Private, ReadOnly, Unspecified
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Vrátí objekt, který představuje alias. K zobrazení objektu použijte rutinu formátu, například Format-List . Ve výchozím nastavení Set-Alias negeneruje žádný výstup.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Určuje obor, ve kterém je tento alias platný. Výchozí hodnota je Místní. Další informace najdete v tématu about_Scopes.

Přijatelné hodnoty jsou následující:

• Globální
• Místní
• Privátní
• Číslování oborů
• Skript

Type:	String
Accepted values:	Global, Local, Private, Numbered scopes, Script
Position:	Named
Default value:	Local
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Value

Určuje název rutiny nebo příkazu, který alias spouští. Parametr Value je vlastnost Definition aliasu.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

None

Set-Alias nepřijímá vstup z kanálu.

Výstupy

None or System.Management.Automation.AliasInfo

Při použití parametru PassThru vygeneruje Set-Aliasobjekt System.Management.Automation.AliasInfo představující alias. V opačném Set-Alias případě negeneruje žádný výstup.

Poznámky

PowerShell obsahuje předdefinované aliasy, které jsou k dispozici v každé relaci PowerShellu. Rutina Get-Alias zobrazí aliasy dostupné v relaci PowerShellu.

Pokud chcete vytvořit nový alias, použijte nebo Set-AliasNew-Alias. Pokud chcete odebrat alias, použijte rutinu Remove-Item . Například, Remove-Item -Path Alias:aliasname.

Pokud chcete vytvořit alias, který je k dispozici v každé relaci PowerShellu, přidejte ho do svého profilu PowerShellu. Další informace najdete v tématu about_Profiles.

Alias je možné uložit a znovu použít v jiné relaci PowerShellu pomocí exportu a importu. Pokud chcete uložit alias do souboru, použijte Export-Alias. Pokud chcete přidat uložený alias do nové relace PowerShellu, použijte Import-Alias.

Související odkazy

• about_Aliases
• about_Functions
• about_Profiles
• about_Scopes
• Export-Alias
• Get-Alias
• Import-Alias
• New-Alias
• Remove-Item