New-Alias
创建新别名。
语法
New-Alias [-Name] <string> [-Value] <string> [-Description <string>] [-Force] [-Option {<None> | <ReadOnly> | <Constant> | <Private> | <AllScope>}] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
说明
New-Alias cmdlet 在当前 Windows PowerShell 会话中创建新别名。退出会话或关闭 Windows PowerShell 之后，不保存通过使用 New-Alias 创建的别名。可以使用 Export-Alias cmdlet 将别名信息保存在文件中。以后可以使用 Import-Alias 检索所保存的别名信息。
参数
-Description <string>
指定别名的说明。可以键入任何字符串。如果说明包括空格，请将其括在引号中。
是否为必需？ |
false |
位置？ |
named |
默认值 |
|
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Force
如果设置，并且已经存在该命名别名，则其行为像 set-alias。
是否为必需？ |
false |
位置？ |
named |
默认值 |
|
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Name <string>
指定新别名。别名中可以使用任何字母数字字符，但第一个字符不能是数字。
是否为必需？ |
true |
位置？ |
1 |
默认值 |
|
是否接受管道输入？ |
true (ByPropertyName) |
是否接受通配符？ |
false |
-Option <ScopedItemOptions>
设置别名的一个或多个可选属性。有效值包括：
-- None：不设置任何选项。（默认）
-- ReadOnly：除非使用 Force 参数，否则无法更改别名。
-- Constant：即使使用 Force 参数，也无法更改别名。
-- Private：别名只在 Scope 参数指定的作用域内可用。在所有其他作用域中它都不可见。
是否为必需？ |
false |
位置？ |
named |
默认值 |
|
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-PassThru
返回一个表示新别名的对象。默认情况下，此 cmdlet 将不产生任何输出。
是否为必需？ |
false |
位置？ |
named |
默认值 |
|
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Scope <string>
指定新别名的作用域。有效值包括“Global”、“Local”、“Script”或者相对于当前作用域的数字（0 到作用域数，其中 0 是指当前作用域，1 是指其父作用域）。默认值为“Local”。有关详细信息，请参阅 about_Scopes。
是否为必需？ |
false |
位置？ |
named |
默认值 |
|
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-Value <string>
指定作为别名的 cmdlet 或命令元素的名称。
是否为必需？ |
true |
位置？ |
2 |
默认值 |
|
是否接受管道输入？ |
true (ByPropertyName) |
是否接受通配符？ |
false |
-Confirm
在执行命令之前提示您进行确认。
是否为必需？ |
false |
位置？ |
named |
默认值 |
|
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
-WhatIf
描述如果执行该命令会发生什么情况（无需实际执行该命令）。
是否为必需？ |
false |
位置？ |
named |
默认值 |
|
是否接受管道输入？ |
false |
是否接受通配符？ |
false |
<CommonParameters>
此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.
输入和输出
输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。
输入 |
无 不能通过管道将输入传递给此 cmdlet。 |
输出 |
“无”或 System.Management.Automation.AliasInfo 如果使用 Passthru 参数，则 New-Alias 生成一个表示新别名的 System.Management.Automation.AliasInfo 对象。否则，此 cmdlet 将不产生任何输出。 |
说明
若要创建新别名，请使用 Set-Alias 或 New-Alias。若要更改别名，请使用 Set-Alias。若要删除别名，请使用 Remove-Item。
示例 1
C:\PS>new-alias list get-childitem
说明
-----------
此命令创建名为“list”的别名，以表示 Get-ChildItem cmdlet。
示例 2
C:\PS>new-alias -name w -value get-wmiobject -description "quick wmi alias" -option ReadOnly
C:\PS> get-alias -name w | format-list *
说明
-----------
此命令创建名为“w”的别名，以表示 Get-WMIObject cmdlet。它为别名创建说明“quick wmi alias”，并使其为只读。该命令的最后一行使用 Get-Alias 获取新别名，并通过管道将它传递给 Format-List 以显示它的所有相关信息。