Sdílet prostřednictvím

New-Alias

  • Reference
Modul:
Microsoft.PowerShell.Utility

Vytvoří nový alias.

Syntaxe

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 Windows PowerShellu. Aliasy vytvořené pomocí New-Alias se po ukončení relace nebo zavření Prostředí Windows PowerShell neuloží. K uložení informací o aliasu do souboru můžete použít rutinu Export-Alias. 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

PS C:\> New-Alias -Name "List" Get-ChildItem

Tento příkaz vytvoří alias s názvem List představující Get-ChildItem rutinu.

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

PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *

Tento příkaz vytvoří alias S, který představuje Get-WmiObject rutinu. Vytvoří popis, rychlý alias wmi pro tento alias a vytvoří ho jen pro čtení. Poslední řádek příkazu používá Get-Alias k získání nového aliasu a ho předá Format-List, aby se zobrazily všechny informace o něm.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Description

Určuje popis aliasu. Můžete zadat libovolný řetězec. Pokud popis obsahuje mezery, uzavřete ho do uvozovek.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Označuje, že rutina funguje jako Set-Alias, pokud alias již existuje.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

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

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Option

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

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

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

Typ:ScopedItemOptions
Přípustné hodnoty:None, ReadOnly, Constant, Private, AllScope, Unspecified
Position:Named
Default value:[System.Management.Automation.ScopedItemOptions]::None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Scope

Určuje rozsah nového aliasu. 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:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Value

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

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Vstup do této rutiny nelze převést.

Výstupy

None or System.Management.Automation.AliasInfo

Při použití parametru PassthruNew-Alias vygeneruje objekt System.Management.Automation.AliasInfo představující nový alias. Jinak tato rutina negeneruje žádný výstup.

Poznámky

  • Pokud chcete vytvořit nový alias, použijte Set-Alias nebo Nový alias. Pokud chcete změnit alias, použijteSet-Alias . Pokud chcete odstranit alias, použijte remove-Item.