Delen via

New-Alias

  • Referentie
Module:
Microsoft.PowerShell.Utility

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 New-Alias-cmdlet maakt een nieuwe alias in de huidige PowerShell-sessie. Aliassen die zijn gemaakt met New-Alias worden niet opgeslagen nadat u de sessie hebt afgesloten of 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

New-Alias -Name "List" Get-ChildItem

Met 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

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

  • None: de alias heeft geen beperkingen (standaardwaarde)
  • ReadOnly: de alias kan worden verwijderd, maar kan niet worden gewijzigd, behalve met behulp van de parameter Force
  • Constant: de alias kan niet worden verwijderd of gewijzigd
  • Private: de alias is alleen beschikbaar in het huidige bereik
  • AllScope: de alias wordt gekopieerd naar nieuwe bereiken die worden gemaakt
  • Unspecified: 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 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:

  • Global
  • Local
  • 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).

Local is de standaardwaarde. Zie about_Scopesvoor 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.