创建新别名。

语法

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 所返回对象的类型。

输入

None

不能通过管道将输入传递给此 cmdlet。

输出

None 或 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 以显示它的所有相关信息。

另请参阅



目录