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 Set-Alias által létrehozott vagy módosított alias nem állandó, és csak az aktuális PowerShell-munkamenetben é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.

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 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 használja csillaggal (*), hogy minden 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éter nincs használatban, a módosítás meghiúsul.

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 határozza meg az elérési utat és az alkalmazás nevét C:\Windows\notepad.exe. A Get-Alias parancsmag a Név paraméterrel jeleníti meg, hogy a np alias notepad.exevan társítva.

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

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. Paraméterekkel és értékekkel (például Set-Location -Path C:\Windows\System32) rendelkező parancsokhoz nem hozható létre alias. 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.

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 könyvtár C:\Windows\System32megadá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 fut, és módosítja a könyvtárat 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 a Option paraméterrel.

Az előző példától folytatva állítsa be az alias GoReadOnly és Private.

Set-Alias -Name Go -Option ReadOnly, Private

Az alias Go már léteznie kell. A 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

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, akkor a leírást idézőjelek közé kell foglalni.

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 tud módosítani vagy törölni olyan aliast, amelynél a Option paraméter konstans van beá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 aliasnevek alfanumerikus karaktereket és kötőjeleket tartalmazhatnak. Az aliasnevek 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 az ReadOnly és az Constant, megvé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:

  • AllScope – Az alias át lesz másolva a létrehozott új hatókörökbe.
  • Constant – Nem módosítható vagy törölhető.
  • None – Nem állít be 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 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 a Option paraméternek értéktömbként vagy az értékek vesszővel elválasztott sztringjeként. A parancsmag egy bináris "VAGY" művelettel kombinálja 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.

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

Megadja, hogy az alias mely hatókörben é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:

  • Global
  • Local
  • Private
  • Numbered scopes
  • Script

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 parancsprogram nem lett futtatva.

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 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 aliast jelöli.

Jegyzetek

A Windows PowerShell a Set-Aliaskövetkező aliasait tartalmazza:

  • sal

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-profiljához. 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.