Megosztás a következőn keresztül:

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

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

Ez a parancs létrehoz egy C nevű aliast a Get-ChildItem parancsmag megjelenítéséhez. Létrehoz egy leírást ( quick gci alias, ), és írásvédetté teszi. A parancs Get-Alias utolsó sora az új alias lekérésére szolgál, és a Format-List továbbítja az összes információ megjelenítéséhez.

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 PowerShell a következő aliasokat tartalmazza New-Alias:

  • Minden platform:

    • 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-Alias.