New-Alias 帮助信息

如下说明是翻译PowerShell中: help New-Alias 产生的帮助信息.

译者: Edengundam(马涛)

 

New-Alias

 

大纲

创建一个新别名.

 

语法

New-Alias [-name] <string> [-value] <string> [-description <string>] [-option {<None> | <ReadOnly> | <Constant> | <Private> | <AllScope>}] [-passThru] [-scope <string>] [-force] [-whatIf] [-confirm] [<CommonParameters>]

 

详细描述

创建一个新别名. 此别名将会被添加到会话中的别名列表. 通过New-Alias创建的别名, 在你退出会话或关闭Windows PowerShell后不会被保存. 你可以使用Export-Alias cmdlet将你的别名信息保存到文件中. 之后你可以使用Import-Alias取得保存的别名信息.

 

参数

 

-name <string>

指定新的别名. 别名可以使用任何数字或字母, 但是第一个字符不能以数字开头.

 

强制参数?	true
参数位置?	1
默认值
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	false

 

-value <string>

指定与之关联的cmdlet或命令元素名称.

 

强制参数?	true
参数位置?	2
默认值
允许从管道绑定输入?	true (根据属性名)
允许通配符扩展?	false

 

-description <string>

指定别名的描述信息. 你可以输入任何的字符串. 如果描述中包含空格, 使用引号将其括起来.

 

强制参数?	False
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-option <ScopedItemOptions>

设置别名的选项(Option)属性.

合法取值如下:

 

·         None: 需选项. (默认)

·         ReadOnly: 除非使用参数Force, 否则别名的属性不能被更改.

·         Constant: 别名不能被更改, 即使使用Force也不允许改变.

·         Private: 别名只能在参数Scope指定的作用域中可见. 在其他的作用域中都不可见.

·         AllScope: 该别名将会被复制到所有作用域中.

 

如下列出此参数接受的参数:

 

·         None

·         ReadOnly

·         Constant

·         Private

·         AllScope

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-passThru <SwitchParameter>

输出此命令创建的对象到管道中. 默认情况下, 此命令不会将对象输出到管道.

 

强制参数?	false
参数位置?	named
默认值	False
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-scope <string>

指定别名导出的作用域. 此值可以是命名作用域: "global", "local"或"script", 也可以是一个相对当前作用于的值(此值范围是从0到当前活动的作用域数量. 0代表当前作用域, 1代表父作用域).

 

 

强制参数?	false
参数位置?	named
默认值	local
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-force <SwitchParameter>

使用此参数, 如果别名已经存在, 行为类似Set-Alias.

 

强制参数?	false
参数位置?	named
默认值	False
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-whatIf

描述执行此命令将会发生的现象, 不会真正执行此命令.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

-confirm

执行命令前提示你进行确认.

 

强制参数?	false
参数位置?	named
默认值
允许从管道绑定输入?	false
允许通配符扩展?	false

 

<公共参数>

此命令支持公共参数: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息, 输入, "get-help about_commonparameters".

 

输入类型

String

 

注意

 

要创建一个新的别名, 使用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

get-alias -name w | format-list *

 

此命令创建一个名为'w'的别名, 来表示Get-WMIObject cmdlet. 它同时为别名创建了描述: "quick wmi alias", 使别名更容易理解. 命令最后一行使用Get-Alias取得新的别名并通过管道传递给Format-List来显示此别名的所有信息.

 

相关链接

Set-Alias

Get-Alias

Export-Alias

Import-Alias