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

Set-Alias

Modul:
Microsoft.PowerShell.Utility Module

Létrehoz vagy módosít egy aliast egy parancsmaghoz vagy más parancshoz az aktuális PowerShell-munkamenetben.

Syntax

Default (Alapértelmezett) 

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

Description

A Set-Alias parancsmag létrehoz vagy módosít egy aliast egy parancsmaghoz vagy parancshoz, például függvényhez, szkripthez, fájlhoz vagy más végrehajtható parancshoz. Az alias egy másik név, amely parancsmagra vagy parancsra hivatkozik. A sal például a Set-Alias parancsmag aliasa. További információ: about_Aliases.

A parancsmagok több aliassal is rendelkezhetnek, de egy alias csak egy parancsmaghoz társítható. A Set-Alias használatával hozzárendelhet egy meglévő aliast egy másik parancsmaghoz, vagy módosíthatja az alias tulajdonságait, például a leírást.

A létrehozott Set-Alias vagy módosított alias nem állandó, és csak az aktuális PowerShell-munkamenet során érhető el. A PowerShell-munkamenet bezárásakor az alias el lesz távolítva.

Példák

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

Ez a parancs létrehoz egy aliast 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 létrehoz egy aliast az aktuális PowerShell-munkamenetben. A Név paraméter az alias nevét adja meg, list. Az Érték paraméter határozza meg az alias által futtatott parancsmagot.

Az alias futtatásához írja be a list a PowerShell parancssorba.

2. példa: Meglévő alias hozzárendelése másik parancsmaghoz

Ez a parancs egy meglévő aliast rendel hozzá 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 Név paramétert használja a list alias megjelenítéséhez. A list alias a Get-ChildItem parancsmaghoz van társítva. Az list alias futtatásakor az aktuális könyvtár elemei jelennek meg.

A Set-Alias parancsmag a Név paramétert használja a list alias megadásához. Az Érték paraméter az aliast a Get-Location parancsmaghoz társítja.

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

3. példa: Írásvédett alias létrehozása és módosítása

Ez a parancs írásvédett aliast hoz létre. Az írásvédett beállítás megakadályozza az aliasok nem szándékos módosítását. Írásvédett alias módosításához vagy törléséhez használja a Force paramétert.

PS> 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

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -Description 'Displays the current directory' -Force -PassThru | 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 létrehoz egy aliast az aktuális PowerShell-munkamenetben. A Név paraméter az alias nevét adja meg, loc. Az Érték paraméter határozza meg az alias által futtatott Get-Location parancsmagot. A Option paraméter a ReadOnly értéket adja meg. A PassThru paraméter az aliasobjektumot jelöli, és elküldi az objektumot a folyamaton a Format-List parancsmagnak. Format-List a Tulajdonság paramétert csillaggal (*) használja, hogy az összes tulajdonság megjelenjen. A példakimenet ezeknek a tulajdonságoknak a részleges listáját jeleníti meg.

A loc alias két paraméter hozzáadásával módosul. Leírás szöveget ad hozzá az alias céljának magyarázatához. A Force paraméterre azért van szükség, mert a loc alias írásvédett. Ha a Force paramétert nem használja, a módosítás sikertelen lesz.

4. példa: Alias létrehozása végrehajtható fájlhoz

Ez a példa létrehoz egy aliast 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 létrehoz egy aliast az aktuális PowerShell-munkamenetben. A Név paraméter az alias nevét adja meg, np. Az Érték paraméter adja meg az elérési utat és az alkalmazás nevétC:\Windows\notepad.exe. A Get-Alias parancsmag a Name paraméterrel mutatja, hogy az np alias a notepad.exe.

Az alias futtatásához írja be np a PowerShell parancssorba a notepad.exemegnyitását.

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

Ez a példa azt mutatja be, hogyan rendelhet aliast egy paraméterekkel rendelkező parancshoz.

Létrehozhat aliast egy parancsmaghoz, például Set-Location. Nem hozhat létre aliast olyan parancsokhoz, amelyek paramétereket és értékeket tartalmaznak, például .Set-Location -Path C:\Windows\System32 Ha aliast szeretne létrehozni egy parancshoz, hozzon létre egy olyan függvényt, amely tartalmazza a parancsot, majd hozzon létre egy aliast a függvényhez. További információ: about_Functions.

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

PS> 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 az Path paraméterrel a C:\Windows\System32 könyvtár megadásához.

A Set-Alias parancsmag létrehoz egy aliast a függvényhez az aktuális PowerShell-munkamenetben. A Név paraméter az alias nevét adja meg, Go. Az Érték paraméter adja meg a függvény nevét, CD32.

Az alias futtatásához írja be a Go a PowerShell parancssorba. A CD32 függvény lefut, és a C:\Windows\System32 könyvtárra változik.

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

A Force paraméter használatával módosíthatja vagy törölheti az Option paramétert a ReadOnly .

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

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
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

Egy új alias nevét adja meg. Az aliasnév alfanumerikus karaktereket tartalmazhat. Az álnevek nem lehetnek numerikusak, például 123.

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 Option tulajdonságértékének beállítása. Az olyan értékek, mint a ReadOnly és a Constant védik az aliasokat a nem kívánt módosításoktól. A munkamenet összes aliasának Option tulajdonságának megtekintéséhez írja be a Get-Alias | Format-Table -Property Name, Options -Autosize.

A paraméter elfogadható értékei a következők:

  • Teljes hatókör Az alias minden létrehozott új hatókörbe átmásolódik.
  • Konstans Nem módosítható vagy törölhető.
  • Egyik sem Nem ad meg beállításokat, és ez az alapértelmezett.
  • Privát Az alias 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ő.
  • Meghatározatlan

Paramétertulajdonságok

Típus:ScopedItemOptions
Alapértelmezett érték:None
Elfogadott értékek:AllScope, Constant, None, Private, ReadOnly, 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

Az aliast jelképező objektumot ad vissza. Az objektum megjelenítéséhez használjon formátumparancsmagot, például Format-List. Alapértelmezés szerint Set-Alias 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

Azt a hatókört adja meg, amelyben az alias érvényes. Az alapértelmezett érték a helyi . További információ található a about_Scopesrészben.

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

  • Globális
  • Helyi
  • Privát
  • Számozott hatókörök
  • Szkript

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:Local
Elfogadott értékek:Global, Local, Private, Numbered scopes, Script
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

Az alias által futtatott parancsmag vagy parancs nevét adja meg. Az Value paraméter az alias Definíció tulajdonsága.

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

Set-Alias nem fogadja el a folyamat bemenetét.

Kimenetek

None or System.Management.Automation.AliasInfo

A PassThru paraméter használatakor Set-Alias létrehoz egy System.Management.Automation.AliasInfo objektumot, amely az aliast jelöli. Ellenkező esetben Set-Alias nem generál kimenetet.

Jegyzetek

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

Új alias létrehozásához használja Set-Alias vagy New-Alias. Alias eltávolításához használja a Remove-Item parancsmagot. Például: Remove-Item -Path Alias:aliasname.

Ha minden PowerShell-munkamenetben elérhető aliast szeretne létrehozni, adja hozzá a PowerShell-profilhoz. További információért lásd: about_Profiles.

Az aliasok exportálással és importálással menthetők és újra felhasználhatók egy másik PowerShell-munkamenetben. Ha egy aliast fájlba szeretne menteni, használja a Export-Alias. Ha egy mentett aliast szeretne hozzáadni egy új PowerShell-munkamenethez, használja a Import-Alias.