New-Alias
Hiermee maakt u een nieuwe alias.
Syntaxis
New-Alias
[-Name] <String>
[-Value] <String>
[-Description <String>]
[-Option <ScopedItemOptions>]
[-PassThru]
[-Scope <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
De cmdlet New-Alias maakt een nieuwe alias in de huidige Windows PowerShell-sessie. Aliassen die zijn gemaakt met New-Alias worden niet opgeslagen nadat u de sessie hebt afgesloten of Windows PowerShell hebt gesloten. U kunt de cmdlet Export-Alias gebruiken om uw aliasgegevens op te slaan in een bestand. U kunt later Import-Alias gebruiken om die opgeslagen aliasgegevens op te halen.
Voorbeelden
Voorbeeld 1: Een alias maken voor een cmdlet
PS C:\> New-Alias -Name "List" Get-ChildItemMet deze opdracht maakt u een alias met de naam List om de Get-ChildItem cmdlet weer te geven.
Voorbeeld 2: Een alleen-lezen alias voor een cmdlet maken
PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *Met deze opdracht maakt u een alias met de naam W die de Get-WmiObject cmdlet vertegenwoordigt. Er wordt een beschrijving, snelle wmi-alias gemaakt voor de alias en wordt deze alleen-lezen. Op de laatste regel van de opdracht wordt Get-Alias gebruikt om de nieuwe alias op te halen en door te geven aan Format-List om alle informatie over de opdracht weer te geven.
Parameters
-Confirm
U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.
| Type: | SwitchParameter |
| Aliassen: | cf |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Force
Geeft aan dat de cmdlet fungeert als Set-Alias als de alias met de naam al bestaat.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Option
Hiermee geeft u de waarde van de eigenschap Options van de alias. Geldige waarden zijn:
- Geen: De alias heeft geen beperkingen (standaardwaarde)
- ReadOnly: De alias kan worden verwijderd, maar kan niet worden gewijzigd, behalve met behulp van de parameter Force
- Constante: De alias kan niet worden verwijderd of gewijzigd
- Privé: De alias is alleen beschikbaar in het huidige bereik
- AllScope: De alias wordt gekopieerd naar nieuwe bereiken die worden gemaakt
- Niet opgegeven: de optie is niet opgegeven
Als u de eigenschap Options van alle aliassen in de sessie wilt zien, typt u Get-Alias | Format-Table -Property Name, Options -AutoSize.
| Type: | ScopedItemOptions |
| Geaccepteerde waarden: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
| Position: | Named |
| Default value: | [System.Management.Automation.ScopedItemOptions]::None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | 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 |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Scope
Hiermee geeft u het bereik van de nieuwe alias. De acceptabele waarden voor deze parameter zijn:
- Globaal
- Lokaal
- Script
- Een getal ten opzichte van het huidige bereik (0 tot het aantal bereiken, waarbij 0 het huidige bereik is en 1 het bovenliggende bereik is).
Lokaal is de standaardinstelling. Zie about_Scopes voor meer informatie.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Value
Hiermee geeft u de naam van de cmdlet of het opdrachtelement dat wordt alias.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Vereist: | True |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-WhatIf
Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
| Type: | SwitchParameter |
| Aliassen: | wi |
| Position: | Named |
| Default value: | False |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
Invoerwaarden
None
U kunt invoer voor deze cmdlet niet doorsluisen.
Uitvoerwaarden
None or System.Management.Automation.AliasInfo
Wanneer u de parameter Passthru gebruikt, genereert New-Alias een System.Management.Automation.AliasInfo object dat de nieuwe alias vertegenwoordigt. Anders genereert deze cmdlet geen uitvoer.
Notities
Als u een nieuwe alias wilt maken, gebruikt u Set-Alias of New-Alias. Als u een alias wilt wijzigen, gebruikt u Set-Alias-. Als u een alias wilt verwijderen, gebruikt u Remove-Item.