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>

使用此参数 , 如果别名已经存在 , 行为类似 S et- A lias.

 

强制参数 ?	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