New-Variable

New-Variable [-Name] <string> [[-Value] <Object>] [-Description <string>] [-Force] [-Option {<None> | <ReadOnly> | <Constant> | <Private> | <AllScope>}] [-PassThru] [-Scope <string>] [-Visibility {<Public> | <Private>}] [-確認] [-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 パラメーターを使用します。

2 番目のコマンドは、同じ名前の変数をもう 1 つ作成しようとします。変数に読み取り専用オプションが設定されているため、エラーが返されます。

3 番目のコマンドは、変数の読み取り専用保護を上書きするために 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 コマンドレットが含まれており、"Counter" という名前のプライベート変数があります。このコマンドでは、値を "Private" に設定した Visibility パラメーターを使用して変数を作成します。

サンプル出力は、プライベート変数の動作を示しています。モジュールを読み込んだユーザーは Counter 変数の値の表示や変更はできませんが、モジュール内でコマンドを使用して Counter 変数の読み取りと変更を行うことができます。