New-Variable

New-Variable [-Name] <string> [[-Value] <Object>] [-Description <string>] [-Force] [-Option {<None> | <ReadOnly> | <Constant> | <Private> | <AllScope>}] [-PassThru] [-Scope <string>] [-Visibility {<Public> | <Private>}] [-Confirm] [-WhatIf] [<CommonParameters>]

C:\PS>new-variable days

说明
-----------
此命令创建名为“days”的新变量。执行该命令后此变量不会立即有值。

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

说明
-----------
此命令创建名为“zipcode”的变量，并为其赋值“98033”。

C:\PS>new-variable -name max -value 256 -option readonly

new-variable -name max -value 1024

new-variable -name max -value 1024 -force

C:\PS> new-variable -name max -value 256 -option readonly

C:\PS> new-variable -name max -value 1024
New-Variable : A variable with name 'max' already exists.
At line:1 char:13
+ new-variable <<<<  -name max -value 1024

C:\PS> new-variable -name max -value 1024 -force

说明
-----------
此示例演示了如何使用 New-Variable 的 ReadOnly 选项保护变量免于被覆盖。

第一个命令创建名为 Max 的新变量，并为其赋值“256”。它使用值为 ReadOnly 的 Option 参数。

第二个命令尝试创建具有相同名称的另一个变量。此命令将返回错误，因为对该变量设置了只读选项。

第三个命令使用 Force 参数覆盖该变量上的只读保护。在此例中，创建具有相同名称的新变量的命令运行成功。

C:\PS>new-variable -name counter -visibility private

#Effect of private variable in a module.

C:\PS> get-variable c*

Name                           Value
----                           -----
Culture                        en-US
ConsoleFileName
ConfirmPreference              High
CommandLineParameters          {}

C:\PS> $counter
"Cannot access the variable '$counter' because it is a private variable"

C:\PS> Get-Counter
Name         Value
----         -----
Counter1     3.1415
...

说明
-----------
此命令演示了模块中专用变量的行为。该模块包含 Get-Counter cmdlet，该 cmdlet 有一个名为“Counter”的专用变量。该命令使用值为“Private”的 Visibility 参数来创建变量。

示例输出显示了专用变量的行为。加载了该模块的用户无法查看或更改 Counter 变量的值，但可以通过该模块中的命令读取和更改 Counter 变量。