New-Alias

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

New-Alias cmdlet 在当前 PowerShell 会话中创建新的别名。 退出会话或关闭 PowerShell 后，不会保存使用 New-Alias 创建的别名。 可以使用 Export-Alias cmdlet 将别名信息保存到文件中。 稍后可以使用 Import-Alias 检索保存的别名信息。

New-Alias -Name "List" Get-ChildItem

此命令创建一个名为 List 的别名来表示 Get-ChildItem cmdlet。

此命令创建一个名为 C 的别名来表示 Get-ChildItem cmdlet。 它为别名创建“快速 gci 别名”的说明，并使它为只读。

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]…}

传递给 Get-Alias 的 Format-List 命令显示有关新别名的所有信息。

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

第一个命令创建函数 Set-ParentDirectory，该函数使用 Set-Location 将工作位置设置为父目录。 第二个命令使用 New-Alias 创建 .. 的别名来调用 Set-ParentDirectory 函数。 由于 Value 参数需要 cmdlet、函数或可执行值，必须创建自定义函数才能创建使用参数的别名。 运行别名 .. 将当前位置更改为父目录。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

不能用管道将对象传送到此 cmdlet。

默认情况下，此 cmdlet 不返回任何输出。

使用 PassThru 参数时，此 cmdlet 返回表示新别名的 AliasInfo 对象。

PowerShell 包含以下与 New-Alias相关的别名：

• 所有平台：

  • nal

• 若要创建新的别名，请使用 Set-Alias 或 New-Alias。 若要更改别名，请使用 Set-Alias。 若要删除别名，请使用 Remove-Alias。