New-Alias

Modul:

Microsoft.PowerShell.Utility Module

Új aliast hoz létre.

Syntax

Default (Alapértelmezett)

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

Description

A New-Alias parancsmag új aliast hoz létre az aktuális PowerShell-munkamenetben. A New-Alias használatával létrehozott aliasok nem lesznek mentve a munkamenetből való kilépés vagy a PowerShell bezárása után. Az Export-Alias parancsmaggal mentheti az aliasadatokat egy fájlba. Később a Import-Alias használatával lekérheti a mentett aliasadatokat.

Példák

1. példa: Alias létrehozása parancsmaghoz

New-Alias -Name "List" Get-ChildItem

Ez a parancs létrehoz egy List nevű aliast a Get-ChildItem parancsmag megjelenítéséhez.

2. példa: Írásvédett alias létrehozása parancsmaghoz

Ez a parancs létrehoz egy C nevű aliast a Get-ChildItem parancsmag megjelenítéséhez. Létrehozza a "Gyors gci alias" leírását az aliashoz, és írásvédetté teszi.

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

HelpUri             : https://go.microsoft.com/fwlink/?LinkID=2096492
ResolvedCommandName : Get-ChildItem
DisplayName         : C -> Get-ChildItem
ReferencedCommand   : Get-ChildItem
ResolvedCommand     : Get-ChildItem
Definition          : Get-ChildItem
Options             : ReadOnly
Description         : Quick gci alias
OutputType          : {System.IO.FileInfo, System.IO.DirectoryInfo}
Name                : C
CommandType         : Alias
Source              :
Version             :
Visibility          : Public
ModuleName          :
Module              :
RemotingCapability  : PowerShell
Parameters          : {[Path, System.Management.Automation.ParameterMetadata], [LiteralPath,
                      System.Management.Automation.ParameterMetadata], [Filter,
                      System.Management.Automation.ParameterMetadata], [Include,
                      System.Management.Automation.ParameterMetadata]…}

A Get-Alias parancs Format-List az új aliassal kapcsolatos összes információt megjeleníti.

3. példa: Alias létrehozása paraméterekkel rendelkező parancshoz

function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory

Az első parancs létrehozza a Set-ParentDirectoryfüggvényt, amely a Set-Location használatával állítja be a munkahelyet a szülőkönyvtárra. A második parancs a New-Alias használatával hozza létre a .. aliasát a Set-ParentDirectory függvény meghívásához. Mivel az Érték paraméter parancsmagot, függvényt vagy végrehajtható értéket igényel, egyéni függvényt kell létrehoznia egy paramétereket használó alias létrehozásához. Az alias futtatása .. az aktuális helyet a szülőkönyvtárra módosítja.

Paraméterek

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cf

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Description

Megadja az alias leírását. Bármilyen sztringet beírhat. Ha a leírás szóközöket tartalmaz, tegye idézőjelek közé.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Force

Azt jelzi, hogy a parancsmag úgy működik, mint Set-Alias, ha az elnevezett alias már létezik.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Name

Megadja az új aliast. Az aliasban bármilyen alfanumerikus karakter használható, de az első karakter nem lehet szám.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	0
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Option

Az alias Beállítások tulajdonságának értékét adja meg. Az érvényes értékek a következők:

• None: Az alias nem rendelkezik korlátozásokkal (alapértelmezett érték)
• ReadOnly: Az alias törölhető, de nem módosítható, kivéve a Force paramétert
• Constant: Az alias nem törölhető vagy módosítható
• Private: Az alias csak az aktuális hatókörben érhető el
• AllScope: Az alias minden létrehozott új hatókörbe lesz másolva
• Unspecified: A beállítás nincs megadva

Ezek az értékek jelölőalapú számbavételként vannak definiálva. Több érték kombinálásával több jelölőt is beállíthat ezzel a paraméterrel. Az értékek átadhatók a Option paraméternek értéktömbként vagy az értékek vesszővel elválasztott sztringjeként. A parancsmag bináris VAGY művelettel egyesíti az értékeket. Az értékek tömbként való átadása a legegyszerűbb lehetőség, és lehetővé teszi a tabulátorkiegészítés használatát is az értékeken.

A munkamenet összes aliasának Beállítások tulajdonságának megtekintéséhez írja be a Get-Alias | Format-Table -Property Name, Options -AutoSize.

Paramétertulajdonságok

Típus:	ScopedItemOptions
Alapértelmezett érték:	[System.Management.Automation.ScopedItemOptions]::None
Elfogadott értékek:	None, ReadOnly, Constant, Private, AllScope, Unspecified
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PassThru

Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Scope

Megadja az új alias hatókörét. A paraméter elfogadható értékei a következők:

• Global
• Local
• Script
• Az aktuális hatókörhöz viszonyított szám (0 a hatókörök számán keresztül, ahol 0 az aktuális hatókör, és a szülője 1).

A Local az alapértelmezett. További információ található a about_Scopesrészben.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Value

Megadja az aliasolt parancsmag vagy parancselem nevét.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	1
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Wi

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

AliasInfo

A PassThru paraméter használatakor ez a parancsmag egy AliasInfo objektumot ad vissza, amely az új aliast jelöli.

Jegyzetek

A Windows PowerShell a New-Aliaskövetkező aliasait tartalmazza:

• nal

• Új alias létrehozásához használja Set-Alias vagy New-Alias. Alias módosításához használja a Set-Alias. Alias törléséhez használja a Remove-Item.

Kapcsolódó hivatkozások

• Export-Alias
• Get-Alias
• Import-Alias
• Álnév-beállítás