New-Alias
Hiermee maakt u een nieuwe alias.
Syntax
New-Alias
[-Name] <String>
[-Value] <String>
[-Description <String>]
[-Option <ScopedItemOptions>]
[-PassThru]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De New-Alias
cmdlet maakt een nieuwe alias in de huidige PowerShell-sessie. Aliassen die zijn gemaakt met behulp New-Alias
van, worden niet opgeslagen nadat u de sessie hebt afgesloten of PowerShell hebt gesloten.
U kunt de Export-Alias
cmdlet gebruiken om uw aliasgegevens op te slaan in een bestand. U kunt deze opgeslagen aliasgegevens later Import-Alias
ophalen.
Voorbeelden
Voorbeeld 1: Een alias maken voor een cmdlet
New-Alias -Name "List" Get-ChildItem
Met deze opdracht maakt u een alias met de naam List om de cmdlet Get-ChildItem weer te geven.
Voorbeeld 2: Een alleen-lezen alias voor een cmdlet maken
New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *
Met deze opdracht maakt u een alias met de naam C
die de Get-ChildItem
cmdlet vertegenwoordigt. Er wordt een beschrijving, snelle wmi-alias gemaakt voor de alias en wordt deze alleen-lezen. De laatste regel van de opdracht gebruikt Get-Alias
om de nieuwe alias op te halen en door te voeren naar Format-List om alle informatie over de alias weer te geven.
Parameters
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Hiermee geeft u een beschrijving van de alias. U kunt elke tekenreeks typen. Als de beschrijving spaties bevat, plaatst u deze tussen aanhalingstekens.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Geeft aan dat de cmdlet fungeert als Set-Alias
de alias met de naam al bestaat.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Hiermee geeft u de nieuwe alias. U kunt alfanumerieke tekens in een alias gebruiken, maar het eerste teken mag geen getal zijn.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Option
Hiermee geeft u de waarde van de eigenschap Opties van de alias. Geldige waarden zijn:
None
: De alias heeft geen beperkingen (standaardwaarde)ReadOnly
: De alias kan worden verwijderd, maar kan niet worden gewijzigd, behalve met behulp van de parameter ForceConstant
: De alias kan niet worden verwijderd of gewijzigdPrivate
: De alias is alleen beschikbaar in het huidige bereikAllScope
: De alias wordt gekopieerd naar nieuwe bereiken die worden gemaaktUnspecified
: De optie is niet opgegeven
Deze waarden worden gedefinieerd als een opsomming op basis van vlaggen. U kunt meerdere waarden combineren om meerdere vlaggen in te stellen met behulp van deze parameter. De waarden kunnen worden doorgegeven aan de parameter Option als een matrix met waarden of als een door komma's gescheiden tekenreeks van deze waarden. De cmdlet combineert de waarden met behulp van een binaire OF-bewerking. Het doorgeven van waarden als een matrix is de eenvoudigste optie en u kunt ook tabvoltooiing gebruiken voor de waarden.
Als u de eigenschap Opties van alle aliassen in de sessie wilt zien, typt u Get-Alias | Format-Table -Property Name, Options -AutoSize
.
Type: | ScopedItemOptions |
Accepted values: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
Position: | Named |
Default value: | [System.Management.Automation.ScopedItemOptions]::None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
Hiermee geeft u het bereik van de nieuwe alias. De aanvaardbare waarden voor deze parameter zijn:
Global
Local
Script
- Een getal ten opzichte van het huidige bereik (0 tot het aantal bereiken, waarbij
0
het huidige bereik is en1
het bovenliggende bereik is).
Local
is de standaardwaarde. Zie about_Scopes voor meer informatie.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Value
Hiermee geeft u de naam van de cmdlet of het opdrachtelement dat wordt alias.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
None
U kunt geen objecten doorsluisen naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert standaard geen uitvoer.
Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een AliasInfo-object dat de nieuwe alias vertegenwoordigt.
Notities
PowerShell bevat de volgende aliassen voor New-Alias
:
Alle platformen:
nal
Als u een nieuwe alias wilt maken, gebruikt
Set-Alias
ofNew-Alias
. Als u een alias wilt wijzigen, gebruikt uSet-Alias
. Als u een alias wilt verwijderen, gebruikt uRemove-Alias
.
Verwante koppelingen
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor