Set-Alias

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

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. sal är till exempel 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.

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 Name 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.

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 Name för att visa list alias. Det list aliaset är associerat med cmdleten Get-ChildItem. När list alias körs visas objekten i den aktuella katalogen.

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

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

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 parametern Force.

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 Name anger aliasets namn loc. Parametern Value anger den Get-Location cmdlet som aliaset kör. Parametern Alternativ anger värdet ReadOnly. Parametern PassThru representerar aliasobjektet och skickar objektet nedåt i pipelinen till cmdleten Format-List. Format-List använder parametern Property med en asterisk (*) så att varje egenskap visas. Exempelutdata visar en partiell lista över dessa egenskaper.

Det loc aliaset ändras med tillägg av två parametrar. Beskrivning lägger till text för att förklara aliasets syfte. Parametern Force krävs eftersom loc alias är skrivskyddat. Om parametern Force inte används misslyckas ändringen.

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 Name anger aliasets namn np. Parametern Value anger sökvägen och programnamnet C:\Windows\notepad.exe. Cmdleten Get-Alias använder parametern Name för att visa att np alias är associerat med notepad.exe.

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

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 Name 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.

Det här exemplet visar hur du tilldelar flera alternativ med 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 parametern Force och är endast tillgängligt i det aktuella omfånget.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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

Som standard returnerar den här cmdleten inga utdata.

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

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. Om du vill ta bort ett alias i PowerShell 6 använder du cmdleten Remove-Alias. 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.