Set-Alias

Syntax

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

Description

Cmdleten Set-Alias skapar eller ändrar ett alias för en cmdlet eller ett kommando, till exempel en funktion, ett skript, en fil eller en annan körbar fil. Ett alias är ett alternativt namn som refererar till en cmdlet eller ett kommando. Är till exempel sal aliaset för cmdleten Set-Alias . Mer information finns i about_Aliases.

En cmdlet kan ha flera alias, men ett alias kan bara associeras med en cmdlet. Du kan använda Set-Alias för att omtilldela ett befintligt alias till en annan cmdlet eller ändra ett alias egenskaper, till exempel beskrivningen.

Ett alias som skapas eller ändras av Set-Alias är inte permanent och är endast tillgängligt under den aktuella PowerShell-sessionen. När PowerShell-sessionen stängs tas aliaset bort.

Exempel

Exempel 1: Skapa ett alias för en cmdlet

Det här kommandot skapar ett alias till en cmdlet i den aktuella PowerShell-sessionen.

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

PS> Get-Alias -Name list

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

Cmdleten Set-Alias skapar ett alias i den aktuella PowerShell-sessionen. Parametern Namn anger aliasets namn, list. Parametern Value anger den cmdlet som aliaset kör.

Om du vill köra aliaset skriver du list på PowerShell-kommandoraden.

Exempel 2: Tilldela om ett befintligt alias till en annan cmdlet

Det här kommandot omtilldelar ett befintligt alias för att köra en annan cmdlet.

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

Cmdleten Get-Alias använder parametern Namn för att visa aliaset list . Aliaset list är associerat med cmdleten Get-ChildItem . När aliaset list körs visas objekten i den aktuella katalogen.

Cmdleten Set-Alias använder parametern Namn för att ange aliaset list . Parametern Value associerar aliaset med cmdleten Get-Location .

Cmdleten Get-Alias använder parametern Namn för att visa aliaset list . Aliaset list är associerat med cmdleten Get-Location . När aliaset list körs visas den aktuella katalogens plats.

Exempel 3: Skapa och ändra ett skrivskyddat alias

Det här kommandot skapar ett skrivskyddat alias. Det skrivskyddade alternativet förhindrar oavsiktliga ändringar av ett alias. Om du vill ändra eller ta bort ett skrivskyddat alias använder du force-parametern.

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

Cmdleten Set-Alias skapar ett alias i den aktuella PowerShell-sessionen. Parametern Namn anger aliasets namn, loc. Parametern Value anger den Get-Location cmdlet som aliaset kör. Parametern Alternativ anger ReadOnly-värdet . Parametern PassThru representerar aliasobjektet och skickar objektet nedåt i pipelinen till cmdleten Format-List . Format-List använder parametern Egenskap med en asterisk (*) så att varje egenskap visas. Exempelutdata visar en partiell lista över dessa egenskaper.

Aliaset loc ändras med tillägg av två parametrar. Beskrivningen lägger till text för att förklara aliasets syfte. Force-parametern behövs eftersom aliaset loc är skrivskyddat. Om force-parametern inte används misslyckas ändringen.

Exempel 4: Skapa ett alias till en körbar fil

Det här exemplet skapar ett alias till en körbar fil på den lokala datorn.

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

PS> Get-Alias -Name np

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

Cmdleten Set-Alias skapar ett alias i den aktuella PowerShell-sessionen. Parametern Namn anger aliasets namn, np. Parametern Value anger sökvägen och programnamnet C:\Windows\notepad.exe. Cmdleten Get-Alias använder parametern Namn för att visa att aliaset np är associerat med notepad.exe.

Om du vill köra aliaset skriver du np på PowerShell-kommandoraden för att öppna notepad.exe.

Exempel 5: Skapa ett alias för ett kommando med parametrar

Det här exemplet visar hur du tilldelar ett alias till ett kommando med parametrar.

Du kan skapa ett alias för en cmdlet, till exempel Set-Location. Du kan inte skapa ett alias för ett kommando med parametrar och värden, till exempel Set-Location -Path C:\Windows\System32. Skapa ett alias för ett kommando genom att skapa en funktion som innehåller kommandot och sedan skapa ett alias för funktionen. Mer information finns i about_Functions.

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

Set-Alias -Name Go -Value CD32

En funktion med namnet CD32 skapas. Funktionen använder cmdleten Set-Location med parametern Path för att ange katalogen , C:\Windows\System32.

Cmdleten Set-Alias skapar ett alias för funktionen i den aktuella PowerShell-sessionen. Parametern Namn anger aliasets namn, Go. Parametern Value anger funktionens namn, CD32.

Om du vill köra aliaset skriver du Go på PowerShell-kommandoraden. Funktionen CD32 körs och ändras till katalogen C:\Windows\System32.

Exempel 6: Uppdatera alternativ för ett befintligt alias

Det här exemplet visar hur du tilldelar flera alternativ med hjälp av parametern Alternativ .

Om du fortsätter från föregående exempel anger du aliaset Go som ReadOnly och Private.

Set-Alias -Name Go -Option ReadOnly, Private

Aliaset Go bör redan finnas. När du har kört kommandot kan aliaset inte ändras utan att använda force-parametern och är endast tillgängligt i det aktuella omfånget.

Parametrar

-Confirm

-Description

-Force

-Name

-Option

-PassThru

-Scope

-Value

-WhatIf

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

AliasInfo

När du använder parametern PassThru returnerar den här cmdleten ett AliasInfo-objekt som representerar aliaset.

Kommentarer

PowerShell innehåller följande alias för Set-Alias:

• Alla plattformar:
  • sal

PowerShell innehåller inbyggda alias som är tillgängliga i varje PowerShell-session. Cmdleten Get-Alias visar de alias som är tillgängliga i en PowerShell-session.

Om du vill skapa ett alias använder du cmdletarna Set-Alias eller New-Alias. Använd cmdleten för att ta bort ett alias i Remove-Alias PowerShell 6. Remove-Item accepteras för bakåtkompatibilitet, till exempel för skript som skapats med tidigare versioner av PowerShell. Använd ett kommando som Remove-Item -Path Alias:aliasname.

Om du vill skapa ett alias som är tillgängligt i varje PowerShell-session lägger du till det i din PowerShell-profil. Mer information finns i about_Profiles.

Ett alias kan sparas och återanvändas i en annan PowerShell-session genom att exportera och importera. Om du vill spara ett alias i en fil använder du Export-Alias. Om du vill lägga till ett sparat alias i en ny PowerShell-session använder du Import-Alias.

Relaterade länkar

• about_Aliases
• about_Functions
• about_Profiles
• about_Scopes
• Export-Alias
• Get-Alias
• Import-Alias
• New-Alias
• Remove-Alias
• Remove-Item