PowerShellで変数に入れた値が表示されない、文章の中に変数名が残る、関数の中で変えた値が外へ伝わらない。まずは代入・引用符・変数が有効な範囲を分けて確認すると、調べる箇所を絞れます。
変数は、値に名前を付けて後から参照する仕組みです。この記事では、通常権限のWindows PowerShellで小さな例を動かし、表示された結果から原因を切り分ける手順を説明します。ファイルの用意は不要です。
掲載結果はWindows PowerShell 5.1.26100.9818の検証記録に基づきます。公式資料はPowerShell 7.5向けですが、7系での実行結果は含みません。例は画面内の変数と関数を作成・削除し、ファイルやシステム設定は変更しません。
先に結論
- 代入と表示は別の操作です。計算結果に疑問があるときは、値と型を確認します。
- 単一引用符では変数名がそのまま残り、二重引用符では変数の値に置き換わります。
- 通常の関数内の代入と、関数の出力を外側で受け取る処理は区別します。
最初に、新しいWindows PowerShell画面を開く
通常権限の新しい画面で、例を一つずつ実行します。
Windowsのスタートメニューで「Windows PowerShell」を検索し、通常権限で開きます。管理者として起動する必要はありません。利用中の作業と分けるため、別の新しい画面を用意してください。
コードは開いた画面へ直接入力します。スクリプトファイルは作成せず、コマンドプロンプトには貼り付けません。掲載結果の対象はWindows PowerShell 5.1です。PowerShell 7系の結果とは分けて比較してください。
- 試す例のコード欄だけをコピーします。出力欄や、行頭のPSなどの入力待ち表示は含めません。
- コード全体を上から順に実行します。貼り付け後に実行されなければ、末尾でEnterキーを押します。
- 表示された結果を掲載の出力と比べ、直後の説明で意味を確認してから次へ進みます。
各例の末尾には、作成した変数や関数を削除する処理があります。途中で止めた場合は、新しく開いた画面を閉じれば、その画面内の変更を片付けられます。HOME、PID、Hostなど、PowerShell自身が使う名前は作業用に流用しません。
値が表示されないときは、代入と表示を分ける
代入しただけでは通常、値は表示されません。
変数名の先頭のドル記号は、変数を表す印です。等号は右側の値を左側の変数へ入れる「代入」に使います。数学で等しさを表す場合とは役割が異なり、値を入れる操作と画面に出す操作は別です。
次の例はlessonCountに3を入れ、2を足した値で更新してから表示します。さらに、値の種類を表す「型」も確認します。GetTypeは型を調べる操作で、後ろの丸括弧はその呼び出し、Nameは型名を取り出す指定です。
代入と型の確認
$lessonCount = 3
$lessonCount = $lessonCount + 2
$lessonCount
$lessonCount.GetType().Name
$lessonText = '3'
$lessonText.GetType().Name
Remove-Variable lessonCount, lessonText
実行結果
5
Int32
String
出力の5は更新後の値、Int32は整数の型名です。Stringは、引用符で囲んだ3が文字列であることを示します。同じ数字に見えても型は異なるため、計算結果に疑問があれば値と型を別々に確認します。
末尾のRemove-Variableは、指定した名前の変数を削除する命令です。この例では、確認に使った2つの変数を片付けています。以降の例でも、最後の削除処理まで実行してください。
文章に変数名が残るときは、引用符を確認する
文章に変数の値を入れる場合は、二重引用符で囲みます。
単一引用符は中の文字をそのまま扱い、二重引用符は中の変数を値に置き換えます。この置き換えを「展開」と呼びます。次の例では、lessonNameに入れたSoraという文字が、引用符によってどう表示されるかを比べます。
3つ目の表示例では、変数名の直後にコロンが続くため、中括弧で変数名の範囲を示しています。どこまでが名前で、どこからが後に続く文字かを区切る指定で、中括弧自体を表示するためではありません。
引用符と変数の区切り
$lessonName = 'Sora'
'Hello $lessonName'
"Hello $lessonName"
"${lessonName}: OK"
Remove-Variable lessonName
実行結果
Hello $lessonName
Hello Sora
Sora: OK
1行目は単一引用符なので変数名が残り、2行目は二重引用符なのでSoraへ置き換わります。3行目はSoraの後にコロンとOKが続きます。名前がそのまま出る場合は、代入の失敗と決めず、まず文章を囲む引用符を確認します。
関数内の変更と、外側で受け取る出力を区別する
通常の関数内で同名変数へ代入しても、外側の値は更新されません。
「関数」は、一連の処理に名前を付けて呼び出せるようにしたものです。functionという指定に続けて名前を書き、中括弧の中へ処理を置きます。次の例では、Get-LessonCountという関数を作成します。
変数の名前を探したり、代入先を決めたりする範囲を「スコープ」と呼びます。通常の関数には呼び出し元とは別のスコープがあります。この例は、外側のlessonCountに10、関数内の同名変数に20を入れて比べます。
関数名を等号の右側に書くと、関数を呼び出し、その出力を左側のlessonResultへ受け取れます。この例では、関数内で単独に書いた変数の値が出力になります。受け取った値と、外側に残る値を順に表示します。
関数の内側と外側
$lessonCount = 10
function Get-LessonCount {
$lessonCount = 20
$lessonCount
}
$lessonResult = Get-LessonCount
$lessonResult
$lessonCount
Remove-Item Function:\Get-LessonCount
Remove-Variable lessonCount, lessonResult
実行結果
20
10
最初の20は関数から受け取った値、次の10は外側に残った値です。関数内で20を代入しても、外側の同名変数は変わっていません。外側を更新するには、出力をその変数へ代入する処理を明示します。その変更例は掲載の検証には含みません。
対象は通常の変数への代入です。配列やオブジェクトというデータのまとまりについて、内部の値を変える操作まで同じ結果になるとは判断しません。末尾のRemove-Itemは、Functionという関数の管理場所から、この例の関数を削除します。
値がないのか、変数そのものがないのかを調べる
値がない状態でも、変数そのものは存在できます。
次の例で使うnullは、値がない状態を表します。lessonValueへその値を入れた後、「値がないか」と「変数が存在するか」を順に調べます。その後に変数を削除し、存在するかをもう一度確認します。
比較に使う-eqは、左右が等しいかを調べる指定です。Get-Variableは変数を探す命令で、-Nameにはドル記号を付けない変数名を渡します。[bool]は、探した結果をTrueまたはFalseという真偽値に変換します。
Trueは条件を満たすこと、Falseは満たさないことを表します。-ErrorAction SilentlyContinueは、変数が見つからない場合のエラー表示を、その命令で抑える指定です。変数の削除後も、存在確認の結果を読みやすくしています。
空の値と未定義を区別する
$lessonValue = $null
$null -eq $lessonValue
[bool](Get-Variable -Name lessonValue -ErrorAction SilentlyContinue)
Remove-Variable lessonValue
[bool](Get-Variable -Name lessonValue -ErrorAction SilentlyContinue)
実行結果
True
True
False
最初のTrueは値がないこと、2つ目のTrueは変数が存在することを示します。Remove-Variableで削除した後はFalseになります。表示が空という見た目だけでは区別できないため、値の比較と存在確認を分けて読み取ります。
配列の先頭番号0と、要素の個数を区別する
2つの値を持つ配列では、先頭の番号は0、個数は2です。
「配列」は、複数の値を順番にまとめたものです。次の例では、アットマークに続く丸括弧の中に、カンマで区切った2つの文字列を入れています。角括弧の中にある0は、先頭の値を取り出す指定です。
Countは、配列に含まれる値の個数を表します。値を取り出すための番号と、全体の個数は別のものです。まとめた値の処理で結果が合わないときは、この例のように取り出した値と個数を別々に表示して確認します。
配列の要素と個数
$lessonItems = @('red', 'blue')
$lessonItems[0]
$lessonItems.Count
Remove-Variable lessonItems
実行結果
red
2
redは先頭の値、2は配列の個数です。先頭番号が0でも、個数が1少なくなるわけではありません。対象は画面内で作成した値であり、外部ファイルからの取り込みやバックアップ操作の結果は、この検証には含みません。
症状に合う例から、確認箇所を絞る
症状に近い例を選び、コード全体と出力を比較します。
次の比較表は、Windows PowerShell 5.1の検証記録を整理したものです。利用中の環境で結果が異なる場合は、まず選んだ例のコード全体を同じ順序で実行したかを確認します。一部だけの実行では、比較の前提がそろいません。
表示されない場合は代入と表示、文章に変数名が残る場合は引用符、関数の外へ変更が伝わらない場合はスコープの例を選びます。症状に応じて見る箇所を分けると、一度に複数の条件を変えずに確認できます。
| 確認する点 | 実行結果 | 判断 |
|---|---|---|
| 数値と文字 | Int32 / String | 見た目の数字だけで型を決めない |
| 単一/二重引用符 | Hello $lessonName / Hello Sora | 展開の有無を選ぶ |
| 関数内/外 | 20 / 10 | 通常の代入は外側を書き換えない |
| 空値/削除 | True, True / False | 値が空でも変数は存在する |
| 配列 | red / 2 | 先頭の番号は0、個数は2 |
表と一致すれば、掲載例と同じ結果が得られています。実際のファイルを扱う処理へ進む前に、まず値だけの小さな例で確認してください。PowerShell 7系や、既存スクリプト固有の設定を含む環境での動作は、掲載の検証結果とは分けて判断します。
