Set-Alias

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

Syntax

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 egy függvényhez, szkripthez, fájlhoz vagy más végrehajtható fájlhoz. Az alias egy parancsmagra vagy parancsra hivatkozó alternatív név. Ez lehet például sal a parancsmag aliasa Set-Alias . További információ: about_Aliases.

Egy parancsmag több aliassal is rendelkezhet, de egy alias csak egy parancsmaghoz társítható. A meglévő aliasok másik parancsmaghoz való hozzárendelésére, illetve az alias tulajdonságainak (például a leírásnak) módosítására is használható Set-Alias .

A létrehozott vagy módosított Set-Alias aliasok nem állandóak, és csak az aktuális PowerShell-munkamenetben érhetők 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 aliast 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 létrehoz egy aliast az aktuális PowerShell-munkamenetben. A Name 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 list a PowerShell parancssorát.

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 Name paramétert használja az list alias megjelenítéséhez. Az list alias a parancsmaghoz Get-ChildItem van társítva. list Az alias futtatásakor megjelennek az aktuális könyvtár elemei.

A Set-Alias parancsmag a Name paraméter használatával adja meg az aliast list . Az Érték paraméter társítja az aliast a Get-Location parancsmaghoz.

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

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 kívánt 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 Name paraméter az alias nevét adja meg. loc Az Érték paraméter határozza meg az Get-Location alias által futtatott parancsmagot. Az Option paraméter a ReadOnly értéket adja meg. A PassThru paraméter az aliasobjektumot jelöli, és elküldi az objektumot a Format-List folyamaton a parancsmagnak. Format-List uses the Property parameter with an asterisk (*) so that all of the properties are displayed. A példakimenet ezen tulajdonságok részleges listáját jeleníti meg.

Az loc alias két paraméter hozzáadásával módosul. A 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 az loc alias írásvédett. Ha a Force paraméter nincs használatban, 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 Name paraméter az alias nevét adja meg. np Az Érték paraméter megadja az elérési utat és az alkalmazás nevét C:\Windows\notepad.exe. A Get-Alias parancsmag a Name paraméterrel mutatja, hogy az np alias notepad.exevan társítva.

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

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

Ez a példa bemutatja, hogyan rendelhet aliast paraméterekkel rendelkező parancsokhoz.

Létrehozhat aliast egy parancsmaghoz, például Set-Location. Paraméterekkel és értékekkel rendelkező parancsokhoz nem hozható létre alias, például Set-Location -Path C:\Windows\System32. Ha aliast szeretne létrehozni egy parancshoz, hozzon létre egy függvényt, amely tartalmazza a parancsot, majd hozzon létre egy aliast 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 függvény neve CD32 . A függvény a Set-Location parancsmagot és a Path paramétert használja a könyvtár megadásához. C:\Windows\System32

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

Az alias futtatásához írja be Go a PowerShell parancssorát. A CD32 függvény fut, és megváltozik a könyvtárban C:\Windows\System32.

6. példa: Meglévő alias frissítési beállításai

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

A fenti példában az aliast Go a következőként ReadOnly fogjuk beállítani: és Private.

Set-Alias -Name Go -Option ReadOnly, Private

Az aliasnak Go már léteznie kell. A fenti parancs futtatása után az alias 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

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

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

-Force

A Force paraméterrel módosíthatja vagy törölheti azt az aliast, amelynek Option paramétere ReadOnly értékre van állítva.

A Force paraméter nem tud módosítani vagy törölni egy állandó értékű Option paraméterrel rendelkező aliast.

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

-Name

Új alias nevét adja meg. Az aliasnevek alfanumerikus karaktereket és kötőjeleket tartalmazhatnak. Az aliasnevek nem lehetnek numerikusak, például 123.

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

-Option

Beállítja az alias Option tulajdonságértékét. Az olyan értékek, mint például ReadOnlyConstant az aliasok védelme a nem kívánt módosításokkal szemben. A munkamenet összes aliasának Option tulajdonságának megtekintéséhez írja be a következőt Get-Alias | Format-Table -Property Name, Options -Autosize: .

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

  • AllScope – Az alias minden létrehozott új hatókörbe át lesz másolva.
  • Constant – Nem módosítható és nem törölhető.
  • None - Nem ad meg beállításokat, és ez az alapértelmezett beállítás.
  • Private – Az alias csak az aktuális hatókörben érhető el.
  • ReadOnly – Csak akkor módosítható vagy törölhető, ha a Force paramétert használja.
  • Unspecified

Ezek az értékek jelző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.

Type:ScopedItemOptions
Accepted values:AllScope, Constant, None, Private, ReadOnly, Unspecified
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Az aliast képviselő objektumot ad vissza. Használjon formátumparancsmagot, például Format-List az objektum megjelenítéséhez. Alapértelmezés szerint Set-Alias nem hoz létre kimenetet.

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

-Scope

Azt a hatókört adja meg, amelyben ez az alias érvényes. Az alapértelmezett érték a Helyi. További információ: about_Scopes.

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

  • Globális
  • Helyi
  • Személyes
  • Számozott hatókörök
  • Script
Type:String
Accepted values:Global, Local, Private, Numbered scopes, Script
Position:Named
Default value:Local
Accept pipeline input:False
Accept wildcard characters:False

-Value

Megadja annak a parancsmagnak vagy parancsnak a nevét, amelyet az alias futtat. Az Érték paraméter az alias Definíció tulajdonsága.

Type:String
Position:1
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

None

Set-Alias A nem fogad bemenetet a folyamatból.

Kimenetek

None or System.Management.Automation.AliasInfo

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

Jegyzetek

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

Alias létrehozásához használja a parancsmagokat Set-Alias vagy New-Aliasa . A PowerShell 6-ban az alias törléséhez használja a Remove-Alias parancsmagot. Remove-Item A a visszamenőleges kompatibilitás, például a PowerShell korábbi verzióival létrehozott szkriptek esetében elfogadott. Használjon például parancsot Remove-Item -Path Alias:aliasname.

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

Az aliasok egy másik PowerShell-munkamenetben menthetők és újra felhasználhatók exportálással és importálással. Ha aliast szeretne menteni egy fájlba, használja Export-Aliasa . Mentett alias új PowerShell-munkamenethez való hozzáadásához használja Import-Aliasa következőt: .