New-Alias

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Új aliast hoz létre.

Syntax

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 használatával New-Alias létrehozott aliasok nem lesznek mentve a munkamenetből való kilépés vagy a PowerShell bezárása után. A Export-Alias parancsmaggal mentheti az aliasadatokat egy fájlba. Később Import-Alias 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 aliast, amely C a Get-ChildItem parancsmagot jelöli. Létrehoz egy leírást, egy gyors wmi-aliast az aliashoz, és írásvédetté teszi. A parancs utolsó sora lekéri Get-Alias az új aliast, és a Format-List fájlba irányítja, hogy megjelenítse az összes információt.

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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é.

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

-Force

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

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

-Name

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

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 csak a Force paraméterrel módosítható
  • 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 át lesz másolva a létrehozott új hatókörökbe
  • 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 az 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 munkamenetben lévő összes alias Beállítások tulajdonságának megtekintéséhez írja be a következőt 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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 van, és 1 a szülője).

A Local az alapértelmezett formátum. További információ: about_Scopes.

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

-Value

Megadja az aliasolt parancsmag vagy parancselem nevét.

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

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 New-Aliastartalmazza:

  • Összes platform:

    • nal

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