Set-Alias

Module:

Microsoft.PowerShell.Utility Module

Hiermee maakt of wijzigt u een alias voor een cmdlet of een andere opdracht in de huidige PowerShell-sessie.

Syntax

Default (Standaard)

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

Description

De Set-Alias cmdlet maakt of wijzigt een alias voor een cmdlet of een opdracht, zoals een functie, script, bestand of ander uitvoerbaar bestand. Een alias is een alternatieve naam die verwijst naar een cmdlet of opdracht. sal is bijvoorbeeld de alias voor de Set-Alias cmdlet. Zie about_Aliasesvoor meer informatie.

Een cmdlet kan meerdere aliassen hebben, maar een alias kan slechts worden gekoppeld aan één cmdlet. Met Set-Alias kunt u een bestaande alias opnieuw toewijzen aan een andere cmdlet of de eigenschappen van een alias wijzigen, zoals de beschrijving.

Een alias die is gemaakt of gewijzigd door Set-Alias is niet permanent en is alleen beschikbaar tijdens de huidige PowerShell-sessie. Wanneer de PowerShell-sessie is gesloten, wordt de alias verwijderd.

Voorbeelden

Voorbeeld 1: Een alias maken voor een cmdlet

Met deze opdracht maakt u een alias voor een cmdlet in de huidige PowerShell-sessie.

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

PS> Get-Alias -Name list

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

De Set-Alias cmdlet maakt een alias in de huidige PowerShell-sessie. De parameter Name geeft de naam van de alias op, list. De parameter waarde geeft de cmdlet op die door de alias wordt uitgevoerd.

Als u de alias wilt uitvoeren, typt u list op de PowerShell-opdrachtregel.

Voorbeeld 2: Een bestaande alias opnieuw toewijzen aan een andere cmdlet

Met deze opdracht wordt een bestaande alias opnieuw toegewezen om een andere cmdlet uit te voeren.

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

De cmdlet Get-Alias gebruikt de parameter Name om de list-alias weer te geven. De list-alias is gekoppeld aan de cmdlet Get-ChildItem. Wanneer de list alias wordt uitgevoerd, worden de items in de huidige map weergegeven.

De Set-Alias-cmdlet gebruikt de parameter Name om de list alias op te geven. De parameter Value koppelt de alias aan de cmdlet Get-Location.

De cmdlet Get-Alias gebruikt de parameter Name om de list-alias weer te geven. De list-alias is gekoppeld aan de cmdlet Get-Location. Wanneer de list alias wordt uitgevoerd, wordt de locatie van de huidige map weergegeven.

Voorbeeld 3: Een alleen-lezenalias maken en wijzigen

Met deze opdracht maakt u een alleen-lezen alias. De optie Alleen-lezen voorkomt onbedoelde wijzigingen in een alias. Als u een alleen-lezen alias wilt wijzigen of verwijderen, gebruikt u de parameter Force.

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

De Set-Alias cmdlet maakt een alias in de huidige PowerShell-sessie. De parameter Name geeft de naam van de alias op, loc. De parameter Waarde geeft de Get-Location cmdlet op die door de alias wordt uitgevoerd. De parameter Option geeft de ReadOnly--waarde op. De parameter PassThru vertegenwoordigt het aliasobject en verzendt het object omlaag in de pijplijn naar de Format-List-cmdlet. Format-List gebruikt de parameter Property met een sterretje (*) zodat alle eigenschappen worden weergegeven. In de voorbeelduitvoer ziet u een gedeeltelijke lijst met deze eigenschappen.

De loc alias wordt gewijzigd met de toevoeging van twee parameters. Beschrijving tekst toevoegt om het doel van de alias uit te leggen. De parameter Forceren is nodig omdat de loc alias alleen-lezen is. Als de parameter Force niet wordt gebruikt, mislukt de wijziging.

Voorbeeld 4: Een alias maken naar een uitvoerbaar bestand

In dit voorbeeld wordt een alias gemaakt naar een uitvoerbaar bestand op de lokale computer.

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

PS> Get-Alias -Name np

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

De Set-Alias cmdlet maakt een alias in de huidige PowerShell-sessie. De parameter Name geeft de naam van de alias op, np. Met de parameter Value geeft u het pad en de toepassingsnaam opC:\Windows\notepad.exe. De Get-Alias cmdlet gebruikt de parameter Name om aan te geven dat de np alias is gekoppeld aan notepad.exe.

Als u de alias wilt uitvoeren, typt u np op de PowerShell-opdrachtregel om notepad.exete openen.

Voorbeeld 5: Een alias maken voor een opdracht met parameters

In dit voorbeeld ziet u hoe u een alias toewijst aan een opdracht met parameters.

U kunt een alias maken voor een cmdlet, zoals Set-Location. U kunt geen alias maken voor een opdracht met parameters en waarden, zoals Set-Location -Path C:\Windows\System32. Als u een alias voor een opdracht wilt maken, maakt u een functie die de opdracht bevat en maakt u vervolgens een alias voor de functie. Zie about_Functionsvoor meer informatie.

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

PS> Set-Alias -Name Go -Value CD32

Er wordt een functie met de naam CD32 gemaakt. De functie gebruikt de Set-Location cmdlet met de parameter Path om de map op te geven, C:\Windows\System32.

De cmdlet Set-Alias maakt een alias voor de functie in de huidige PowerShell-sessie. De parameter Name geeft de naam van de alias op, Go. De parameter Waarde geeft de naam van de functie op, CD32.

Als u de alias wilt uitvoeren, typt u Go op de PowerShell-opdrachtregel. De CD32 functie wordt uitgevoerd en gewijzigd in de map C:\Windows\System32.

Parameters

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:	SwitchParameter
Default value:	False
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Cf

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Description

Hiermee geeft u een beschrijving van de alias. U kunt elke tekenreeks typen. Als de beschrijving spaties bevat, plaatst u er enkele aanhalingstekens bij.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Force

Gebruik de parameter Forceren om een alias te wijzigen of verwijderen waarvoor de parameter Option is ingesteld op ReadOnly-.

De parameter Force kan een alias niet wijzigen of verwijderen als de parameter Option is ingesteld op Constant.

Parametereigenschappen

Type:	SwitchParameter
Default value:	False
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Name

Hiermee geeft u de naam van een nieuwe alias. De naam van een alias kan alfanumerieke tekens bevatten. Aliasnamen mogen niet numeriek zijn, zoals 123.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	0
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-Option

Hiermee stelt u de Option eigenschapswaarde van de alias in. Waarden zoals ReadOnly en Constant beschermen een alias tegen onbedoelde wijzigingen. Als u de eigenschap Option van alle aliassen in de sessie wilt zien, typt u Get-Alias | Format-Table -Property Name, Options -Autosize.

De acceptabele waarden voor deze parameter zijn als volgt:

• AllScope De alias wordt gekopieerd naar alle nieuwe scopes die worden gemaakt.
• Constant Kan niet worden gewijzigd of verwijderd.
• Geen Stelt geen opties in en is de standaardinstelling.
• Privé De alias is alleen beschikbaar in het huidige bereik.
• Alleen lezen Kan niet worden gewijzigd of verwijderd, tenzij de parameter Force wordt gebruikt.
• niet-opgegeven

Parametereigenschappen

Type:	ScopedItemOptions
Default value:	None
Geaccepteerde waarden:	AllScope, Constant, None, Private, ReadOnly, Unspecified
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-PassThru

Retourneert een object dat de alias vertegenwoordigt. Gebruik een indelings-cmdlet zoals Format-List om het object weer te geven. Standaard genereert Set-Alias geen uitvoer.

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Scope

Hiermee geeft u het bereik op waarin deze alias geldig is. De standaardwaarde is Lokale. Zie about_Scopesvoor meer informatie.

De acceptabele waarden zijn als volgt:

• Globaal
• Lokaal
• Privé
• Genummerde scopes
• Script

Parametereigenschappen

Type:	String
Default value:	Local
Geaccepteerde waarden:	Global, Local, Private, Numbered scopes, Script
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Value

Hiermee geeft u de naam op van de cmdlet of opdracht die door de alias wordt uitgevoerd. De parameter Value is de eigenschap Definition van de alias.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	1
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:	SwitchParameter
Default value:	False
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Wi

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

None

Set-Alias Accepteert geen invoer van de pijplijn.

Uitvoerwaarden

None or System.Management.Automation.AliasInfo

Wanneer u de parameter PassThru gebruikt, Set-Alias wordt een System.Management.Automation.AliasInfo-object gegenereerd dat de alias vertegenwoordigt. Anders, Set-Alias genereert geen output.

Notities

PowerShell bevat ingebouwde aliassen die beschikbaar zijn in elke PowerShell-sessie. De Get-Alias-cmdlet geeft de aliassen weer die beschikbaar zijn in een PowerShell-sessie.

Als u een nieuwe alias wilt maken, gebruikt u Set-Alias of New-Alias. Als u een alias wilt verwijderen, gebruikt u de cmdlet Remove-Item. Bijvoorbeeld: Remove-Item -Path Alias:aliasname.

Als u een alias wilt maken die beschikbaar is in elke PowerShell-sessie, voegt u deze toe aan uw PowerShell-profiel. Zie about_Profilesvoor meer informatie.

Een alias kan worden opgeslagen en opnieuw worden gebruikt in een andere PowerShell-sessie door een export en import uit te voeren. Als u een alias wilt opslaan in een bestand, gebruikt u Export-Alias. Als u een opgeslagen alias wilt toevoegen aan een nieuwe PowerShell-sessie, gebruikt u Import-Alias.

Verwante koppelingen

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