New-Alias

Hiermee maakt u een nieuwe alias.

Syntax

Default (Standaard)

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 Get-ChildItem cmdlet weer te geven.

Voorbeeld 2: Een alleen-lezen alias voor een cmdlet maken

Met deze opdracht maakt u een alias met de naam C die de Get-ChildItem cmdlet vertegenwoordigt. Er wordt een beschrijving gemaakt van 'Snelle gci-alias' voor de alias en wordt deze alleen-lezen.

New-Alias -Name "C" -Value Get-ChildItem -Description "Quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *
HelpUri             : https://go.microsoft.com/fwlink/?LinkID=2096492
ResolvedCommandName : Get-ChildItem
DisplayName         : C -> Get-ChildItem
ReferencedCommand   : Get-ChildItem
ResolvedCommand     : Get-ChildItem
Definition          : Get-ChildItem
Options             : ReadOnly
Description         : Quick gci alias
OutputType          : {System.IO.FileInfo, System.IO.DirectoryInfo}
Name                : C
CommandType         : Alias
Source              :
Version             :
Visibility          : Public
ModuleName          :
Module              :
RemotingCapability  : PowerShell
Parameters          : {[Path, System.Management.Automation.ParameterMetadata], [LiteralPath,
                      System.Management.Automation.ParameterMetadata], [Filter,
                      System.Management.Automation.ParameterMetadata], [Include,
                      System.Management.Automation.ParameterMetadata]…}

De Get-Alias opdracht wordt doorgesluisd om alle informatie over de nieuwe alias weer te Format-List geven.

Voorbeeld 3: Een alias maken voor een opdracht met parameters

function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory

Met de eerste opdracht wordt de functie Set-ParentDirectorygemaakt, waarmee Set-Location de werklocatie wordt ingesteld op de bovenliggende map. Met de tweede opdracht New-Alias maakt u een alias van het aanroepen van .. de Set-ParentDirectory functie. Omdat voor de parameter Waarde een cmdlet, functie of uitvoerbare waarde is vereist, moet u een aangepaste functie maken om een alias te maken die gebruikmaakt van parameters. Als u de alias .. uitvoert, wordt de huidige locatie gewijzigd in de bovenliggende map.

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 deze tussen aanhalingstekens.

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

Geeft aan dat de cmdlet fungeert als Set-Alias de alias met de naam al bestaat.

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

-Name

Hiermee geeft u de nieuwe alias. U kunt alfanumerieke tekens in een alias gebruiken, maar het eerste teken mag geen getal zijn.

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 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 elke nieuwe scope die wordt 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 Opties van alle aliassen in de sessie wilt zien, typt u Get-Alias | Format-Table -Property Name, Options -AutoSize.

Parametereigenschappen

Type:ScopedItemOptions
Default value:[System.Management.Automation.ScopedItemOptions]::None
Geaccepteerde waarden:None, ReadOnly, Constant, Private, AllScope, 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 het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard 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 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.

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

-Value

Hiermee geeft u de naam van de cmdlet of het opdrachtelement dat wordt 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

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

AliasInfo

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

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