New-Variable 帮助信息

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

译者: Edengundam(马涛)

 

New-Variable

 

大纲

创建一个新变量.

 

语法

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

 

详细描述

创建一个新变量. 默认情况下它不会对变量赋初值.

 

参数

 

-name <string>

新变量的名称

 

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

 

-value <Object>

赋给变量的值

 

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

 

-scope <string>

指定该变量的生存作用域(译者注: 原文此处使用了单词export, 在其他的shell中, 一般父进程通过export将变量传递给子进程. ). 此值可以是命名作用域: "global", "local"或"script", 也可以是一个相对当前作用于的值(此值范围是从0到当前活动的作用域数量. 0代表当前作用域, 1代表父作用域).

 

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

 

-description <string>

变量的用户描述信息

 

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

 

-option <ScopedItemOptions>

可能的值包括ReadOnly, Constant和Private.  允许使用它们的各种组合.

 

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

 

·         None

·         ReadOnly

·         Constant

·         Private

·         AllScope

 

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

 

-force <SwitchParameter>

在不破坏安全性的前提下, 能够避免影响命令成功执行的限制条件, 例如: 更改已经存在的变量名. 设置变量时, 用来尽最大努力执行操作(译者注: 设置为Constant则不能成功).

 

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

 

-passThru <SwitchParameter>

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

 

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

 

注意

 

更多信息, 输入"Get-Help New-Variable  -detailed".需要技术信息, 输入"Get-Help New-Variable -full".

 

如果需要为该命令提供多个参数, 请使用逗号进行分隔. 例如, "<parameter-name> <value1>, <value2>".

 

例1

 

C:/PS>new-variable days

 

此命令创建一个名为days的新变量. 在命令刚刚执行结束后它还没有被赋任何初值.

 

例2

 

C:/PS>new-variable zipcode -value 98033

 

此命令创建一个名为zipcode的变量, 并且为其赋值为98033.

 

相关链接

Get-Variable

Set-Variable

Remove-Variable

Clear-Variable