New-Alias
创建新的别名。
语法
Default （默认值）
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 检索保存的别名信息。
示例
示例 1：为 cmdlet 创建别名
New-Alias -Name "List" Get-ChildItem
此命令创建一个名为 List 的别名来表示 Get-ChildItem cmdlet。
示例 2：为 cmdlet 创建只读别名
New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *
此命令创建一个名为 C 的别名来表示 Get-ChildItem cmdlet。 它为别名创建说明、快速 wmi 别名，并使它只读。 该命令的最后一行用于 Get-Alias 获取新别名并将其通过管道传输到 Format-List 以显示有关它的所有信息。
参数
-Confirm
在运行 cmdlet 之前，提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Description
指定别名的说明。 可以键入任何字符串。 如果说明包含空格，请用引号将其括起来。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Force
指示 cmdlet 的行为类似于 Set-Alias（如果已命名的别名已存在）。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
指定新的别名。 可以在别名中使用任何字母数字字符，但第一个字符不能是数字。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Option
指定别名的 Options 属性的值。 有效值为：
-
None：别名没有约束（默认值） -
ReadOnly：可以使用 Force 参数来删除别名，但不能更改别名 -
Constant：无法删除或更改别名 -
Private：别名仅在当前范围内可用 -
AllScope：别名复制到任何创建的新作用域。 -
Unspecified：未指定选项
这些值被定义为以标志为基础的枚举。 可以使用此参数将多个值组合在一起以设置多个标志。 可以将值作为值数组或这些值的逗号分隔字符串传递给 Option 参数。 该 cmdlet 将使用二进制 OR作合并这些值。 将值作为数组传递是最简单的选项，还允许对值使用 Tab 补全。
若要查看会话中所有别名的 Options 属性，请键入 Get-Alias | Format-Table -Property Name, Options -AutoSize。
参数属性
| 类型: | ScopedItemOptions |
| 默认值: | [System.Management.Automation.ScopedItemOptions]::None |
| 接受的值: | None, ReadOnly, Constant, Private, AllScope, Unspecified |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PassThru
返回一个对象，该对象表示你正在处理的项目。 默认情况下，此 cmdlet 不生成任何输出。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Scope
指定新别名的范围。 此参数的可接受值为：
GlobalLocalScript- 一个相对于当前范围的数字（0 到范围的数目，其中
0是当前范围，1是它的父范围）。
Local 是默认值。 有关详细信息，请参阅 about_Scopes。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Value
指定要别名的 cmdlet 或命令元素的名称。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
None
不能通过管道将输入传递给此 cmdlet。
输出
None or System.Management.Automation.AliasInfo
使用 Passthru 参数时， New-Alias 生成表示新别名的 System.Management.Automation.AliasInfo 对象。 否则，此 cmdlet 不会生成任何输出。
备注
- 若要创建新的别名，请使用
Set-Alias或New-Alias。 若要更改别名，请使用Set-Alias。 若要删除别名，请使用Remove-Item。