New-Alias

  • Reference
Modul:
Microsoft.PowerShell.Utility

Vytvoří nový alias.

Syntax

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

Description

Rutina New-Alias vytvoří nový alias v aktuální relaci PowerShellu. Aliasy vytvořené pomocí použití New-Alias se po ukončení relace nebo zavření PowerShellu neuloží. Pomocí této rutiny Export-Alias můžete uložit informace o aliasu do souboru. Později můžete použít Import-Alias k načtení informací o uloženém aliasu.

Příklady

Příklad 1: Vytvoření aliasu pro rutinu

New-Alias -Name "List" Get-ChildItem

Tento příkaz vytvoří alias s názvem List, který představuje rutinu Get-ChildItem.

Příklad 2: Vytvoření aliasu jen pro čtení pro rutinu

New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *

Tento příkaz vytvoří alias s názvem C představující rutinu Get-ChildItem . Vytvoří popis, rychlý alias wmi pro tento alias a vytvoří ho jen pro čtení. Poslední řádek příkazu slouží Get-Alias k získání nového aliasu a jeho nasmátku do format-list, aby se zobrazily všechny informace o něm.

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 ho do uvozovek.

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

-Force

Označuje, že rutina funguje, jako Set-Alias kdyby alias s názvem již existuje.

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

-Name

Určuje nový alias. V aliasu můžete použít libovolné alfanumerické znaky, ale první znak nemůže být číslo.

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

-Option

Určuje hodnotu vlastnosti Options aliasu. Platné hodnoty jsou:

  • None: Alias nemá žádná omezení (výchozí hodnota)
  • ReadOnly: Alias lze odstranit, ale nelze jej změnit s výjimkou použití parametru Force .
  • Constant: Alias nelze odstranit ani změnit.
  • Private: Alias je k dispozici pouze v aktuálním oboru.
  • AllScope: Alias se zkopíruje do všech nově vytvořených oborů.
  • Unspecified: Možnost není zadána.

Tyto hodnoty jsou definovány jako výčet založený na příznaku. Pomocí tohoto parametru můžete zkombinovat více hodnot a nastavit více příznaků. Hodnoty lze předat parametru Option jako pole hodnot nebo jako řetězec oddělený čárkami těchto hodnot. Rutina zkombinuje hodnoty pomocí binární operace OR. Předání hodnot jako pole je nejjednodušší možností a také umožňuje použít pro hodnoty dokončování tabulátoru.

Chcete-li zobrazit vlastnost Možnosti všech aliasů v relaci, zadejte Get-Alias | Format-Table -Property Name, Options -AutoSize.

Type:ScopedItemOptions
Accepted values:None, ReadOnly, Constant, Private, AllScope, Unspecified
Position:Named
Default value:[System.Management.Automation.ScopedItemOptions]::None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.

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

-Scope

Určuje rozsah nového aliasu. 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.

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

-Value

Určuje název rutiny nebo elementu příkazu, který se aliasuje.

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

Do této rutiny nemůžete roušit objekty.

Výstupy

None

Ve výchozím nastavení tato rutina nevrací žádný výstup.

AliasInfo

Pokud použijete parametr PassThru , vrátí tato rutina objekt AliasInfo představující nový alias.

Poznámky

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

  • Všechny platformy:

    • nal

  • Chcete-li vytvořit nový alias, použijte Set-Alias nebo New-Alias. Pokud chcete změnit alias, použijte Set-Alias. Pokud chcete odstranit alias, použijte Remove-Alias.