Delen via

New-Alias

  • Referentie
Module:
Microsoft.PowerShell.Utility

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 van New-Alias , 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 later gebruiken Import-Alias om die opgeslagen aliasgegevens op te halen.

Voorbeelden

Voorbeeld 1: Creatie een alias voor een cmdlet

New-Alias -Name "List" Get-ChildItem

Met deze opdracht maakt u een alias met de naam List die de cmdlet Get-ChildItem vertegenwoordigt.

Voorbeeld 2: Creatie een alleen-lezen alias voor een cmdlet

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. Hiermee maakt u een beschrijving, snelle wmi-alias, voor de alias en maakt deze alleen-lezen. De laatste regel van de opdracht gebruikt Get-Alias om de nieuwe alias op te halen en deze om te leiden 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 werkt als Set-Alias of 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 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 een vlag. 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 van waarden of als een door komma's gescheiden tekenreeks van deze waarden. De cmdlet combineert de waarden met behulp van een binaire-OR-bewerking. Het doorgeven van waarden als een matrix is de eenvoudigste optie en stelt u ook in staat om tab-voltooiing te 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 vertegenwoordigt 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 op. De aanvaardbare waarden voor deze parameter zijn:

  • Global
  • Local
  • Script
  • Een getal dat relatief is ten opzichte van het huidige bereik (0 door het aantal bereiken, waarbij 0 het huidige bereik is en 1 het bovenliggende bereik).

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 op van de cmdlet of het opdrachtelement waarvan de alias wordt opgegeven.

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 invoer doorspezen naar deze cmdlet.

Uitvoerwaarden

None or System.Management.Automation.AliasInfo

Wanneer u de parameter Passthru gebruikt, New-Alias wordt een System.Management.Automation.AliasInfo-object gegenereerd dat de nieuwe alias vertegenwoordigt. Anders genereert deze cmdlet geen uitvoer.

Notities

  • Als u een nieuwe alias wilt maken, gebruikt Set-Alias u of New-Alias. Als u een alias wilt wijzigen, gebruikt u Set-Alias. Als u een alias wilt verwijderen, gebruikt u Remove-Item.