Set-Alias (Microsoft.PowerShell.Utility)

Set-Alias

Modul:

Microsoft.PowerShell.Utility

Fedőnevet hoz létre vagy módosít egy parancsmaghoz vagy más parancshoz az aktuális PowerShell-munkamenetben.

Szintaxis

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

Leírás

A Set-Alias parancsmag álnevet hoz létre vagy módosít egy parancsmaghoz vagy parancshoz, például függvényhez, szkripthez, fájlhoz vagy más végrehajtható fájlhoz. Az álnév egy alternatív név, amely parancsmagra vagy parancsra utal. Például a sal az Set-Alias parancsmag álneve. További információért lásd: about_Aliases.

Egy parancsmagnak több álneve is lehet, de egy álnév csak egy parancsmaghoz társítható. Az Set-Alias segítségével egy meglévő álnevet hozzárendelhet egy másik parancsmaghoz, vagy módosíthatja az álnév tulajdonságait, például a leírást.

A Set-Alias által létrehozott vagy módosított álnév nem állandó, és csak az aktuális PowerShell-munkamenet során érhető el. A PowerShell-munkamenet bezárásakor az álnév törlődik.

Példák

1. példa: Hozzon létre egy álnevet egy parancsmaghoz

Ez a parancs álnevet hoz létre egy parancsmaghoz az aktuális PowerShell-munkamenetben.

PS> Set-Alias -Name list -Value Get-ChildItem

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

A Set-Alias parancsmag álnevet hoz létre az aktuális PowerShell-munkamenetben. A Name paraméter határozza meg az alias nevét, a list. Az Érték paraméter határozza meg az alias által futtatott parancsmagot.

Az álnév futtatásához írja be a list parancsot a PowerShell parancssorába.

2. példa: Rendeljen újra egy meglévő álnevet egy másik parancsmaghoz

Ez a parancs átrendeli egy meglévő álnevet egy másik parancsmag futtatásához.

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

PS> Set-Alias -Name list -Value Get-Location

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-Location

A Get-Alias parancsmag a Name paramétert használja a list alias megjelenítéséhez. A list álnév a Get-ChildItem parancsmaghoz van társítva. A lista álnév futtatásakor az aktuális könyvtár elemei jelennek meg.

A Set-Alias parancsmag a Name paramétert használja a list alias megadásához. A Value paraméter az álnevet a Get-Location parancsmaghoz társítja.

A Get-Alias parancsmag a Name paramétert használja a list alias megjelenítéséhez. A list alias a Get-Location parancsmaghoz van társítva. A list álnév futtatásakor az aktuális könyvtár helye jelenik meg.

3. példa: Csak olvasható álnév létrehozása és módosítása

Ez a parancs csak olvasható álnevet hoz létre. A csak olvasható beállítás megakadályozza az álnév nem kívánt módosítását. A csak olvasható alias módosításához vagy törléséhez használja a Kényszerítés paramétert.

Set-Alias -Name loc -Value Get-Location -Option ReadOnly -PassThru |
    Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         :
Name                : loc
CommandType         : Alias

$Parameters = @{
    Name        =  'loc'
    Value       =  (Get-Location)
    Option      =  'ReadOnly'
    Description =  'Displays the current directory'
    Force       = $true
    PassThru    = $true
}
Set-Alias @Parameters | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         : Displays the current directory
Name                : loc
CommandType         : Alias

A Set-Alias parancsmag álnevet hoz létre az aktuális PowerShell-munkamenetben. A Name paraméter határozza meg az alias nevét, loc. A Value paraméter határozza meg az alias által futtatott Get-Location parancsmagot. Az Option paraméter az Csak olvasható értéket adja meg. A PassThru paraméter az álnév objektumot képviseli, és elküldi az objektumot a folyamatban a Format-List parancsmaghoz. A Format-List a Property paramétert használja csillaggal (*), így minden tulajdonság megjelenik. A példa kimenete a tulajdonságok részleges listáját mutatja.

A loc álnév két paraméter hozzáadásával módosul. A Leírás szöveggel magyarázza az alias célját. A Force paraméterre azért van szükség, mert a loc álnév csak olvasható. Ha nem használja a Force paramétert, a módosítás sikertelen.

4. példa: Hozzon létre álnevet egy végrehajtható fájlhoz

Ez a példa egy álnevet hoz létre egy végrehajtható fájlhoz a helyi számítógépen.

PS> Set-Alias -Name np -Value C:\Windows\notepad.exe

PS> Get-Alias -Name np

CommandType     Name
-----------     ----
Alias           np -> notepad.exe

A Set-Alias parancsmag álnevet hoz létre az aktuális PowerShell-munkamenetben. A Name paraméter határozza meg az alias nevét, np. Az Value paraméter adja meg az elérési utat és az alkalmazás nevét: C:\Windows\notepad.exe. A Get-Alias parancsmag a Name paramétert használja annak kimutatására, hogy az np alias a notepad.exe fájlhoz van társítva.

Az álnév futtatásához írja be az np parancsot a PowerShell parancssorába a notepad.exe megnyitásához.

5. példa: Hozzon létre álnevet egy parancshoz paraméterekkel

Ez a példa bemutatja, hogyan rendelhet hozzá álnevet egy paraméterekkel rendelkező parancshoz.

Létrehozhat egy aliast egy parancsmaghoz, például Set-Location. Nem hozhat létre álnevet paraméterekkel és értékekkel rendelkező parancsokhoz, például Hely beállítása -C elérési út:\Windows\System32. Ha álnevet szeretne létrehozni egy parancshoz, hozzon létre egy függvényt, amely tartalmazza a parancsot, majd hozzon létre egy álnevet a függvényhez. További információ: about_Functions.

Function CD32 {Set-Location -Path C:\Windows\System32}

Set-Alias -Name Go -Value CD32

Létrejön egy CD32 nevű függvény. A függvény a Set-Location parancsmagot használja a Path paraméterrel a C:\Windows\System32 könyvtár megadásához.

A Set-Alias parancsmag álnevet hoz létre a függvényhez az aktuális PowerShell-munkamenetben. A Name paraméter határozza meg az alias nevét, Go. Az Value paraméter adja meg a függvény nevét, CD32.

Az álnév futtatásához írja be a Go parancsot a PowerShell parancssorába. A CD32 függvény lefut, és átvált a C:\Windows\System32 könyvtárba.

6. példa: Frissítse a meglévő álnév beállításait

Ez a példa bemutatja, hogyan rendelhet hozzá több beállítást az Option paraméter használatával.

Az előző példát folytatva állítsa be az Go álnevet ReadOnly és Private értékre.

Set-Alias -Name Go -Option ReadOnly, Private

A Go aliasnak már léteznie kell. A parancs futtatása után az álnév nem módosítható a Force paraméter használata nélkül, és csak az aktuális hatókörben érhető el.

Paraméterek

-Confirm

A parancsmag futtatása előtt megerősítést kér.

Típus:

SwitchParameter

Álnevek:

cf

Pozíció:

Elnevezett

Alapértelmezett érték:

False

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-Description

Megadja az álnév leírását. Bármilyen karakterláncot beírhat. Ha a leírás szóközt tartalmaz, tegye idézőjelek közé.

Típus:

String

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-Force

Használja a Force paramétert egy olyan alias módosításához vagy törléséhez, amelynél az Option paraméter ReadOnly-ra van állítva.

A Force paraméter nem módosíthatja vagy törölheti az álnevet, ha az Option paraméter Constant-ra van állítva.

Típus:

SwitchParameter

Pozíció:

Elnevezett

Alapértelmezett érték:

False

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-Name

Megadja az új álnév nevét. Az alias név alfanumerikus karaktereket és kötőjeleket tartalmazhat. Az álnevek nem lehetnek numerikusak, például 123.

Típus:

String

Pozíció:

0

Alapértelmezett érték:

None

Kívánt:

True

Csővezeték bevitel elfogadása:

True

Helyettesítő karakterek elfogadása:

False

-Option

Beállítja az alias Option tulajdonságának értékét. Az olyan értékek, mint a ReadOnly és a Constant, megvédik az álnevet a nem kívánt változtatásoktól. A munkamenetben lévő összes álnév Option tulajdonságának megtekintéséhez írja be a Get-Alias | Format-Table -Tulajdonság neve, Opciók -Automatikus méretezés.

Ennek a paraméternek az elfogadható értékei a következők:

• AllScope - Az álnevet minden létrehozott új hatókörbe másolja.
• Állandó - Nem módosítható vagy törölhető.
• Nincs - Nincs beállítás, és ez az alapértelmezett.
• Privát - Az álnév csak az aktuális hatókörben érhető el.
• Csak olvasható - A Force paraméter használata nélkül nem módosítható vagy törölhető.

Unspecified

Ezek az értékek zászló alapú felsorolásként vannak definiálva. Több értéket kombinálhat több jelző beállításához ezzel a paraméterrel. Az értékek átadhatók az Option paraméternek értékek tömbjeként vagy ezen értékek vesszővel elválasztott karakterláncaként. A parancsmag bináris VAGY művelettel egyesíti az értékeket. Az értékek tömbként történő átadása a legegyszerűbb lehetőség, és lehetővé teszi a tabulátor-kiegészítés használatát is az értékeken.

Típus:

ScopedItemOptions

Elfogadott értékek:

AllScope, Állandó, Nincs, Privát, Csak olvasható, Meghatározatlan

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-PassThru

Egy objektumot ad vissza, amely az álnevet képviseli. Használjon formátumú parancsmagot, például Format-List-t az objektum megjelenítéséhez. Alapértelmezés szerint a Set-Alias nem generál semmilyen kimenetet.

Típus:

SwitchParameter

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-Scope

Meghatározza, hogy ez az álnév milyen hatókörben érvényes. Az alapértelmezett érték a Helyi. További információ: about_Scopes.

Az elfogadható értékek a következők:

Global

Local

Private

Numbered scopes

Script

Típus:

String

Elfogadott értékek:

Globális, helyi, privát, számozott hatókör, Script

Pozíció:

Elnevezett

Alapértelmezett érték:

Helyi

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-Value

Megadja annak a parancsmagnak vagy parancsnak a nevét, amelyet az álnév futtat. Az Érték paraméter az alias Definition tulajdonsága.

Típus:

String

Pozíció:

1

Alapértelmezett érték:

None

Kívánt:

True

Csővezeték bevitel elfogadása:

True

Helyettesítő karakterek elfogadása:

False

-WhatIf

Megmutatja, mi történik, ha a parancsmag lefut. A parancsmag nem fut.

Típus:

SwitchParameter

Álnevek:

wi

Pozíció:

Elnevezett

Alapértelmezett érték:

False

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

Bemenetek

Nincs

Ehhez a parancsmaghoz nem lehet objektumokat vezetni.

Kimenetek

Nincs

Alapértelmezés szerint ez a parancsmag nem ad vissza kimenetet.

AliasInfo

Ha a PassThru paramétert használja, ez a parancsmag egy AliasInfo objektumot ad vissza, amely az álnevet képviseli.

Megjegyzések

A PowerShell a következő álneveket tartalmazza a Set-Alias számára:

• Minden platform:

  sal

A PowerShell beépített álneveket tartalmaz, amelyek minden PowerShell-munkamenetben elérhetők. A Get-Alias parancsmag megjeleníti a PowerShell-munkamenetben elérhető álneveket.

Alias létrehozásához használja a Set-Alias vagy New-Alias parancsmagot. A PowerShell 6-ban az álnév törléséhez használja az Remove-Alias parancsmagot. Az Elem eltávolítása visszamenőleges kompatibilitás miatt elfogadott, például a PowerShell korábbi verzióival létrehozott szkriptek esetében. Használjon parancsot, például Elem eltávolítása -Path Alias:aliasname.

Az egyes PowerShell-munkamenetekben elérhető alias létrehozásához adja hozzá a PowerShell-profiljához. További információért lásd: about_Profiles.

Egy alias menthető és újra felhasználható egy másik PowerShell-munkamenetben exportálás és importálás végrehajtásával. Az alias fájlba mentéséhez használja az Export-Alias parancsot. Ha mentett aliast szeretne hozzáadni egy új PowerShell-munkamenethez, használja az Import-Alias parancsot.