HOME > Variable系コマンドレット > New-Variable
New-Variable
New-Variableは、変数を作成するコマンドです。
エイリアスnv
解説
新規の変数を定義したい時に使用します。
既に同名の変数が存在する場合はエラーになります。
既存の変数の値を変更したい場合は、Set-Variableをご使用ください。
構文
- （構文）
- New-Variable [-Name] <string> [[-Value] <Object>] [<CommonParameters>]
| パラメータ | 説明 |
|---|---|
| -Name 変数名 | 対象の変数を指定する |
| -Value 値 | 値を指定する |
| -Description 値 | 説明を指定する |
| -Option 値 | 変数のオプションを指定する ・None：何も指定しない（デフォルト） ・Constant：定数 ・Private：プライベートスコープのみ対象 ・ReadOnly：読取専用 ・AllScope：全てのスコープにコピーする |
| -Visibility 値 | セッション外で表示するかどうかを指定する ・Public：表示される（デフォルト） ・Private：表示されない |
| -Force | 強制的に実行する |
| -PassThru | 通常は出力しない値を出力るようにする |
| -Scope 値 | 対象とするスコープを指定する ・Global：どこからでもアクセス可能 ・Local：現在のスコープのみアクセス可能（デフォルト） ・Script：スクリプト内のみアクセス可能 |
| -WhatIf | 実行はせずに実行結果の確認のみ行う |
| -Confirm | 実行前に確認メッセージの表示を行う |
共通的なパラメータは「共通パラメータ」をご覧ください。
サンプル
新規に変数aを作成し、値ABCをセットする
New-Variable -Name a -Value "ABC"
コマンドのヘルプを表示する
Get-Help New-Variable
備考
- パラメータ名の「Name」と「Value」は省略可能です。
関連項目
- Variable系コマンドレット
- Get-Variable：変数を取得する
- Set-Variable：変数を設定する
- New-Variable：変数を作成する
- Clear-Variable：変数の値をクリアする
- Remove-Variable：変数の定義を削除する
