New-Alias
Vytvoří nový alias.
Syntax
Default (Výchozí)
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 cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
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 |
-Description
Určuje popis aliasu. Můžete zadat libovolný řetězec. Pokud popis obsahuje mezery, uzavřete ho do uvozovek.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| 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 |
-Force
Označuje, že rutina funguje jako Set-Alias, pokud alias již existuje.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| 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 |
-Name
Určuje nový alias. V aliasu můžete použít libovolné alfanumerické znaky, ale první znak nemůže být číslo.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | 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.
Vlastnosti parametru
| Typ: | ScopedItemOptions |
| Default value: | [System.Management.Automation.ScopedItemOptions]::None |
| Přípustné hodnoty: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
| 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 |
-PassThru
Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina negeneruje žádný výstup.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| 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 |
-Scope
Určuje rozsah nového aliasu. 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: | None |
| 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 |
-Value
Určuje název rutiny nebo elementu příkazu, který se aliasuje.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
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
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 tento příkaz 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žijte
Set-Alias . Pokud chcete odstranit alias, použijte remove-Item.