Set-Variable

Set-Variable コマンドレットは、指定した変数に値を割り当てるか、現在の値を変更します。 変数が存在しない場合は、コマンドレットによって作成されます。

PS C:\> Set-Variable -Name "desc" -Value "A description"
PS C:\> Get-Variable -Name "desc"

これらのコマンドは、desc 変数の値を A description に設定し、変数の値を取得します。

PS C:\> Set-Variable -Name "processes" -Value (Get-Process) -Option constant -Scope global -Description "All processes" -PassThru | Format-List -Property *

このコマンドは、システム上のすべてのプロセスを含むグローバルな読み取り専用変数を作成し、変数のすべてのプロパティを表示します。

このコマンドでは、Set-Variable コマンドレットを使用して変数を作成します。 PassThru パラメーターを使用して新しい変数を表すオブジェクトを作成し、パイプライン演算子 (|) を使用してオブジェクトを Format-List コマンドレットに渡します。 新しく作成された変数のすべてのプロパティを表示するには、Format-List の Property パラメーターと all (*) の値を使用します。

値 "(Get-Process)" は、変数に格納される前に実行されるようにかっこで囲まれています。 それ以外の場合、変数には "Get-Process" という単語が含まれます。

PS C:\> New-Variable -Name "counter" -Visibility Public -Value 26
PS C:\> $Counter
26
PS C:\> Get-Variable c*

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

PS C:\> Set-Variable -Name "counter" -Visibility Private
PS C:\> Get-Variable c*

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

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

PS C:\> .\use-counter.ps1
#Commands completed successfully.

このコマンドは、変数の可視性を Private に変更する方法を示します。 この変数は、必要なアクセス許可を持つスクリプトで読み取りおよび変更できますが、ユーザーには表示されません。

サンプル出力は、パブリック変数とプライベート変数の動作の違いを示しています。

Object

変数の値を表すオブジェクトをパイプ処理して、Set-Variableを できます。

None or System.Management.Automation.PSVariable

PassThru パラメーターを使用すると、Set-Variable 、新しい変数または変更された変数を表す System.Management.Automation.PSVariable オブジェクトが生成されます。 それ以外の場合、このコマンドレットは出力を生成しません。