Set-Alias

  • Referencia
Modul:
Microsoft.PowerShell.Utility

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 parancshoz 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. Például sal a parancsmag aliasa Set-Alias . További információ: about_Aliases.

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

A létrehozott vagy módosított Set-Alias aliasok nem állandóak, és csak az aktuális PowerShell-munkamenet során é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 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 az alias által futtatott parancsmagot adja meg.

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

A Set-Alias parancsmag a Név paramétert használja az 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 az list alias megjelenítéséhez. Az list alias a Get-Location parancsmaghoz van társítva. list Az 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 az Get-Location alias által futtatott parancsmagot adja meg. Az Option paraméter a ReadOnly értéket adja meg. A PassThru paraméter az alias objektumot jelöli, és elküldi az objektumot a folyamatból a Format-List parancsmagnak. Format-ListA Tulajdonság paramétert csillaggal (*) használja, hogy minden tulajdonság megjelenjen. A példakimenet ezeknek a tulajdonságoknak a 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 nem használja a Force paramétert, 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 megadja 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 az alias társítva notepad.exevan.np>

Az alias futtatásához írja be np a PowerShell parancssorba a megnyitáshoz notepad.exe.

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 paraméterekkel és értékekkel rendelkező parancsokhoz, 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.

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

Set-Alias -Name Go -Value CD32

Létrejön egy elnevezett CD32 függvény. A függvény az Set-Location Elérési út paraméterrel rendelkező parancsmaggal adja meg a könyvtárat. C:\Windows\System32

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 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 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 az Option paraméterrel.

Az előző példától folytatva állítsa be az aliast Go a következőként ReadOnly : és Private.

Set-Alias -Name Go -Option ReadOnly, Private

Az aliasnak 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

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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, akkor a leírást idézőjelek közé kell foglalni.

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

-Force

A Force paraméter használatával módosíthatja vagy törölheti azt az aliast, amelynek Beállítás paramétere ReadOnly értékre van állítva.

A Force paraméter nem tud módosítani vagy törölni egy aliast, amelynek beállításparamétere Konstans.

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

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

-Option

Az alias Option tulajdonságértékének beállítása. Az olyan értékek, mint például ReadOnly az aliasok védelme a Constant nem kívánt módosításokkal szemben. A munkamenetben lévő összes alias 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ó vagy 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 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 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Az aliast jelképező 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Megadja, hogy az alias mely hatókörben érvényes. Az alapértelmezett érték a Helyi érték. További információ: about_Scopes.

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

  • Global
  • Local
  • Private
  • Numbered scopes
  • Script
Type:String
Accepted values:Global, Local, Private, Numbered scopes, Script
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Value

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

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

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 PowerShell a következő aliasokat Set-Aliastartalmazza:

  • Minden platform:
    • 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.

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

Ha minden PowerShell-munkamenetben elérhető aliast szeretne létrehozni, adja hozzá a PowerShell-profiljához. További információ: 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 következőt Export-Alias: . Ha egy mentett aliast szeretne hozzáadni egy új PowerShell-munkamenethez, használja a következőt Import-Alias: .