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