New-Alias

New-Alias
    [-Name] <String>
    [-Value] <String>
    [-Description <String>]
    [-Option <ScopedItemOptions>]
    [-PassThru]
    [-Scope <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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.

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.

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 doorgesluisd naar Format-List toont alle informatie over de nieuwe alias.

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

Met de eerste opdracht maakt u de functie Set-ParentDirectory, die gebruikmaakt van Set-Location om de werklocatie in te stellen op de bovenliggende map. De tweede opdracht gebruikt New-Alias om een alias van .. te maken om de Set-ParentDirectory-functie aan te roepen. 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 .. wijzigt u de huidige locatie in de bovenliggende map.

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt geen objecten doorsluisen naar deze cmdlet.

Deze cmdlet retourneert standaard geen uitvoer.

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een AliasInfo--object dat de nieuwe alias vertegenwoordigt.

PowerShell bevat de volgende aliassen voor New-Alias:

• Alle platforms:

  • nal

• 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-Alias.