New-Alias
Ú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 Windows PowerShell-munkamenetben. A New-Alias használatával létrehozott aliasok nem lesznek mentve a munkamenetből való kilépés vagy a Windows PowerShell bezárása után. Az Export-Alias parancsmaggal mentheti az aliasadatokat egy fájlba. Később az Import-Alias használatával lekérheti a mentett aliasadatokat.
Példák
1. példa: Alias létrehozása parancsmaghoz
PS C:\> 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
PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *
Ez a parancs létrehoz egy W nevű aliast a Get-WmiObject parancsmag megjelenítéséhez. Létrehoz egy leírást, egy gyors wmi-aliast az aliashoz, és írásvédetté teszi. A parancs utolsó sora az Get-Alias használatával lekéri az új aliast, és az Format-List az összes információt megjeleníti.
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:
- Nincs: 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éter használatával
- Állandó: Az alias nem törölhető vagy módosítható
- Privát: Az alias csak az aktuális hatókörben érhető el
- AllScope: Az alias a létrehozott új hatókörökbe lesz másolva
- Meghatározatlan: A beállítás nincs megadva
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:
- Globális
- Helyi
- Szkript
- Az aktuális hatókörhöz viszonyított szám (0 a hatókörök számán keresztül, ahol a 0 az aktuális hatókör, az 1 pedig a szülője).
A helyi az alapértelmezett. További információ: about_Scopes.
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 csövezhet be bemenetet.
Kimenetek
None or System.Management.Automation.AliasInfo
A Passthru paraméter használatakor New-Alias létrehoz egy System.Management.Automation.AliasInfo objektumot, amely az új aliast jelöli. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.
Jegyzetek
Új alias létrehozásához használja a Set-Alias vagy a New-Alias parancsot. Alias módosításához használja Set-Alias. Alias törléséhez használja az Remove-Item parancsot.