PowerShell ISEとVS Codeの設定手順:版の確認からデバッグまで

PowerShellの開発環境を、本体の版の確認、4行の保存と実行、停止前後の値の確認という3段階で示した独自図解。

VS Codeで想定したPowerShellの版が動かない、ISEと同じコードなのに結果が違う。そんなときは、コードを書くエディターと、実行するPowerShell本体を分けて確認すると、原因を絞れます。

この記事ではWindowsを対象に、版の確認、VS CodeとMicrosoftのPowerShell拡張の準備、4行のファイルの保存を順に説明します。その後、処理を途中で止めて値を調べる「デバッグ」を、VS CodeとISEで確認する手順へ進みます。

掲載例の実行環境はWindows PowerShell 5.1.26100.9818です。導入済みのPowerShell 7を選ぶ場所も示しますが、7系での実行と両エディターの画面操作は今回の実行検証に含みません。画面操作の手順は公式資料に基づく案内です。

先に結論

  • ISEはWindows PowerShell 5.1までに対応します。新機能の開発停止は、セキュリティ等の保守終了を意味しません。
  • VS Codeの通常ターミナルとPowerShell拡張のセッションは別に確認し、選択した本体と実際の版番号を照合します。
  • 練習用ファイルは4行全体を実行します。3行目の停止時点は計算前で、1行進めた後に変数totalが360になります。

ISEとVS Codeでは、実行する本体の選び方が違う

エディターの名前だけでは、動いているPowerShellの版は分かりません。

PowerShell本体は命令を解釈して実行するプログラム、エディターはコードを書くアプリです。拡張機能は、エディターに入力補完やデバッグなどの機能を加える部品です。

ISEはWindows向けの編集・実行環境で、Windows PowerShell 5.1までに対応します。新機能の開発は停止していますが、MicrosoftはWindowsの構成要素としてセキュリティ等の重要な修正を継続すると説明しています。

新しく準備する場合は、Microsoftが推奨するVS CodeとPowerShell拡張が選択肢になります。PowerShell 7は5.1と並存できますが、7を導入してもISEが実行する本体は7へ変わりません。

選ぶ環境 実行する本体 始める前に知ること
Windows PowerShell ISE Windows PowerShell 5.1まで Windows用。新機能の開発は停止、セキュリティ等の保守は継続
VS CodeとMicrosoftのPowerShell拡張 インストール済みのPowerShellをセッションで選ぶ エディターと拡張だけではPowerShell 7本体は入らない
通常のターミナル そのターミナルで起動した本体 拡張が使うセッションと同じ版とは限らない

以降は、Windows PowerShellで版を確認し、VS Codeで練習用ファイルを作る順に進みます。ISEも比較したい場合は、後半のISEの節で同じファイルを開きます。

最初にPowerShellの版と実行場所を確認する

まず、Windows標準のWindows PowerShellを開いて、本体の情報を読みます。今回の計算例に管理者権限は必要ありません。入力を待つPSから始まる行が、コマンドを入力する場所です。

コードのドル記号は変数を表します。変数は情報や値を名前で参照する仕組みです。PSVersionTableは本体の情報を持ち、PSVersionは版、PSEditionは系統を示します。HostのNameは、入出力を受け持つプログラムである「ホスト」の名前です。

  1. Windowsのスタートメニューで「Windows PowerShell」を検索し、通常の権限で起動します。
  2. 下のコード欄の3行を上から順に入力し、それぞれEnterを押します。実行結果欄の文字は入力しません。

動いているPowerShell本体とホストを確認する

$PSVersionTable.PSVersion.ToString()
$PSVersionTable.PSEdition
$Host.Name

実行結果

5.1.26100.9818
Desktop
ConsoleHost

出力は上から版番号、系統、ホスト名です。掲載結果の5.1.26100.9818、Desktop、ConsoleHostは、独立したWindows PowerShellのコンソールでの値です。細かな版番号やホスト名は環境によって変わります。

版番号が5.1で始まり、系統がDesktopなら、今回の5.1向け手順の対象です。PowerShell 7を利用する場合も、系統のCoreという表示だけで判断せず、1行目の版番号を確認します。

同じ3行を、後でISEのコンソール欄とVS CodeのPowerShell拡張の端末でも実行します。同じPCでも、入力する場所によって別の本体が動くことがあるためです。

VS CodeにMicrosoftのPowerShell拡張を追加する

PowerShell拡張の導入だけでは、PowerShell 7本体は追加されません。

VS Codeが未導入なら、Microsoft公式のVisual Studio CodeダウンロードページでWindows向けのインストーラーを選び、案内に従って導入します。導入済みならスタートメニューから開きます。Visual Studioとは別のアプリです。

既存のWindows PowerShell 5.1を選ぶ場合、拡張の対応はベストエフォート、つまり可能な範囲での対応です。.NET Framework 4.8以上という実行基盤も必要です。

新しく本体を選ぶ場合は、現在サポートされているPowerShell 7の利用を検討します。PowerShell 7を新しく導入する場合は、MicrosoftのWindows向けインストール手順で別途準備します。職場のPCでは、アプリや拡張機能を導入できるか管理者へ確認してください。

  1. VS CodeでCtrl+Shift+Xを押し、拡張機能の一覧を開きます。
  2. 検索欄へPowerShellと入力し、発行元がMicrosoftの「PowerShell」を選んでインストールします。
  3. 再読み込みを求められた場合は、画面の案内に従います。

拡張が利用する本体は、練習用ファイルを保存してから選びます。先にファイルを用意することで、編集するファイル、選択した本体、実行する場所を順に確認できます。

練習用フォルダーに4行のファイルを保存する

5.1で日本語を含むファイルを読むため、UTF-8 with BOMで保存します。

練習用ファイルは、自分が書き込める場所にまとめます。ここではドキュメントなどにPowerShellEditorLabというフォルダーを作り、その中へeditor-check.ps1を保存します。末尾のps1は、PowerShellのスクリプトファイルを表す拡張子です。

VS Codeの既定のUTF-8はBOMなしです。日本語を含む今回のファイルは5.1でも読むため、UTF-8 with BOMを選びます。BOMは、文字コードを判別する助けになるファイル先頭の印です。

  1. エクスプローラーでドキュメントなどを開き、PowerShellEditorLabという新しいフォルダーを作ります。
  2. VS Codeの「ファイル→フォルダーを開く」でそのフォルダーを選びます。信頼の確認が出たら、自分で作成し、中身を確認したフォルダーかを確かめます。
  3. 「ファイル→新しいテキストファイル」を開き、下のコード欄の4行すべてを貼り付けます。Ctrl+Shift+Sなどの保存操作で、作成したフォルダーへeditor-check.ps1という名前で保存します。
  4. 画面右下の文字コード表示を選び、「エンコード付きで保存」から「UTF-8 with BOM」を選んで保存し直します。

editor-check.ps1に保存する4行

$items = 3
$unitPrice = 120
$total = $items * $unitPrice
"合計: $total"

実行結果

合計: 360

変数itemsには個数の3、unitPriceには単価の120を入れます。等号は値の代入、アスタリスクは掛け算を表します。3行目で計算結果をtotalへ入れ、4行目で表示します。二重引用符の中の変数は、その値に置き換わります。

実行結果欄の「合計: 360」は、4行をWindows PowerShell 5.1で最後まで実行した出力です。この文字列をファイルへ追加する必要はありません。掲載の4行は、計算と文字の表示だけを行い、ファイルや設定を書き換えません。

PowerShell拡張が実行する版を選び直す

拡張のセッションを選び、その端末で版番号を読みます。

保存したeditor-check.ps1のタブを開いたまま、PowerShell拡張が利用する本体を選びます。セッションとは、ひと続きの操作や変数を保持する実行の場です。拡張が利用するセッションは、通常のターミナルとは区別します。

「ターミナル→新しいターミナル」で開いた端末の版を変えても、拡張のセッションを切り替えたことにはなりません。次の操作では、PowerShell拡張が作る端末を選んで確認します。

  1. 右下の言語表示がPowerShellになっているか確認します。違う場合は、言語表示からPowerShellを選びます。
  2. Ctrl+Shift+Pでコマンドパレットを開きます。これは、操作名を入力して探す検索欄です。PowerShell: Show Session Menuを検索して選びます。
  3. 一覧からWindows PowerShell 5.1、または導入済みのPowerShell 7を選びます。
  4. 画面下の端末一覧で、PowerShell Extensionなど、PowerShell拡張が作る端末を選びます。「最初にPowerShellの版と実行場所を確認する」の3行を入力し、版とホストを確認します。

選択した本体と、版確認の1行目に出る番号が一致していれば、実行する版を確認できています。7が一覧にない場合は、本体が未導入か、拡張がその保存場所を検出できていない可能性があります。5.1を選ぶ場合は、先述した拡張の対応範囲と前提も確認します。

VS Codeで全体を実行し、3行目の前後を比べる

3行目で止まった時点では、その行の計算はまだ実行されていません。

editor-check.ps1を保存し、最初はコードを選択せずに4行全体を実行します。その後、3行目に停止点を置き、計算前と計算後の値を比べます。途中で処理を止めるための目印を、ブレークポイントと呼びます。

今回はフォルダーを開いているため、初回はCtrl+Shift+Dで「実行とデバッグ」を開き、「launch.jsonファイルを作成します」を選びます。環境はPowerShell、起動方法は「Launch Current File」を選びます。

launch.jsonは起動対象などを保存する設定ファイルで、練習用フォルダー内の.vscodeフォルダーへ作成されます。既にある場合は作り直さず、上部の起動構成の一覧で現在のファイルを実行するPowerShellの構成を選びます。

実行前にeditor-check.ps1のタブへ戻します。設定が別のスクリプトを指定している場合は中止し、起動対象を確認してください。単体ファイルだけを開いたデバッグと、フォルダーを開いた今回の準備を分けて進めます。

  1. F5でデバッグを開始し、PowerShell拡張の端末に「合計: 360」が出ることを確認します。エラーが出た場合は、後半の実行ポリシーと症状別の確認へ進みます。
  2. 計算を行う3行目にカーソルを置いてF9を押し、停止点の印を付けます。
  3. もう一度F5を押します。3行目で停止したら、左側の「実行とデバッグ」の変数表示や、変数へマウスを合わせた表示で、itemsが3、unitPriceが120かを確認します。
  4. F10で3行目を1行進め、totalが360になったことを確認します。この時点では、表示を行う4行目はまだ実行していません。
  5. F5で最後まで進め、端末に「合計: 360」が出ることを確認します。
  6. 途中で終える場合はShift+F5でデバッグを停止します。停止点が不要になったら、3行目でF9を押し直して外します。
確認するタイミング items / unitPrice totalと表示
3行目へ到達した直後 3 / 120 計算行はまだ未実行。前回の値が残る場合もある
3行目を1行進めた後 3 / 120 totalは360。表示用の4行目はまだ実行していない
4行目まで実行した後 3 / 120 合計: 360 と表示する

停止した行は、これから実行する行です。3行目で止まった時点のtotalには、前回の360などが残る場合があります。その値だけを今回の計算結果と判断せず、F10で進めた後の値と、最後の表示を分けて確認します。

独立したWindows PowerShell 5.1での検証記録では、3行目の実行直前にitemsが3、unitPriceが120、totalが未設定でした。その後の出力は「合計: 360」です。停止点による観測であり、VS Codeの画面やF9・F10の操作を実施した結果ではありません。

ISEでも同じファイルを開いて値を確認する

ISEを比較したい場合は、先ほど保存した同じeditor-check.ps1を開きます。WindowsキーとRを押して「ファイル名を指定して実行」を開き、powershell_ise.exeと入力します。見つからない場合は、そのWindows環境でISEを利用できない可能性があります。

ISEには、コードを書くスクリプト欄と、命令を入力するコンソール欄があります。PSから始まる入力待ちの行がコンソール欄です。まずそこで版確認の3行を順に実行し、5.1系であることを確認します。

  1. 「ファイル→開く」でPowerShellEditorLabのeditor-check.ps1を選びます。スクリプト欄が隠れている場合は、「表示→スクリプトウィンドウの表示」で開きます。
  2. コードが4行で保存されていることを確認し、F5で全体を実行します。コンソール欄に「合計: 360」が出ることを確認します。
  3. 3行目にカーソルを置き、F9で停止点を付けてからF5で再実行します。停止後、コンソール欄で変数itemsとunitPriceをそれぞれドル記号付きで入力し、3と120を確認します。
  4. F10で3行目を進めてから、コンソール欄で変数totalをドル記号付きで入力し、360を確認します。F5で最後まで進め、表示も確認します。
  5. 途中で中止する場合はShift+F5、停止点を外す場合は同じ行でF9を押します。練習を終えたらファイルを保存し、ISEを閉じます。

ISEはPowerShell 7を実行する環境ではありません。7を利用する場合は、VS CodeのPowerShell拡張など、対応する環境を選びます。

F8などによる部分実行では、先に必要な代入行を実行し忘れることがあります。この練習では4行全体の実行を基準にします。途中の1行だけを実行した結果と比べるときは、変数に残っている値にも注意してください。

実行が拒否されたら、ポリシーの適用範囲を読む

設定を変更する前に、失敗した実行場所で現在の規則を確認します。

「スクリプトの実行が無効」などのエラーが出た場合は、実行ポリシーを確認します。実行ポリシーは、スクリプトファイルを実行する際の規則です。次のコードは適用範囲ごとの値を読み取り、設定を変更しません。

入力する場所は、実際に失敗したISEのコンソール欄、またはVS CodeのPowerShell拡張の端末です。別の端末で確認すると、失敗した実行場所の状況と取り違えることがあります。

実行を止める規則の適用範囲を確認する

Get-ExecutionPolicy -List

実行結果

Scope ExecutionPolicy
        ----- ---------------
MachinePolicy       Undefined
   UserPolicy       Undefined
      Process       Undefined
  CurrentUser    RemoteSigned
 LocalMachine       Undefined

出力のScopeは適用範囲、ExecutionPolicyは設定値です。Undefinedは、その範囲では未設定という意味です。実行できるかどうかを、この表示だけで判断することはできません。掲載結果は検証環境の値で、読者のPCへ合わせる目標値ではありません。

MachinePolicyやUserPolicyに設定がある場合は、組織の管理設定が関係する可能性があります。グループポリシーによる設定が優先されるため、エラー全文、本体の版、適用範囲の表示を管理者へ伝えます。制限を回避する変更や、一律の解除は行いません。

実行ポリシーは、ファイルの安全を保証する仕組みではありません。警告がなくても、知らないスクリプトは中身と入手元の確認が必要です。今回の検証でも、実行ポリシーは変更していません。

結果が違うときは、症状から確認箇所を選ぶ

本体の版、保存ファイル、実行した行を一つずつ照合します。

ISEとVS Codeで結果が違う場合は、同じ本体の版、同じ保存ファイル、同じ4行を扱っているか確認します。複数の設定をまとめて変えず、次の症状に当てはまる箇所から読み直すと、条件の違いを追いやすくなります。

  • 想定した版と違う:通常ターミナルの表示だけで判断せず、ISEのコンソール欄、またはPowerShell拡張の端末で版確認の3行を実行します。VS Codeではセッションの選択も見直します。
  • 日本語だけが崩れる:保存文字コードを確認します。5.1でも読む今回のファイルはUTF-8 with BOMで保存し直し、4行全体を実行します。
  • 合計が表示されない:ファイル名がeditor-check.ps1.txtになっていないか、4行目まで保存したか、停止点で止まっていないかを確認します。
  • totalが古い値に見える:3行目の実行前か後かを確認します。F10で計算行を進めた後の値と、最後の表示を照合します。
  • PowerShell拡張が動かない:発行元がMicrosoftか、拡張が有効か、選択した本体が利用できるかを確認します。5.1では、アプリの動作を支える.NET Framework 4.8も公式手順の前提です。判断できなければエラーを保存して管理者へ相談します。

練習後に計算用の変数を残したくなければ、練習に利用したISEや拡張のセッションを閉じます。作成したフォルダーとファイルが不要になった場合は、エクスプローラーで場所と中身を確認してから削除できます。

ここで確認するのは、小さなコードの保存、全体実行、値の追跡です。実務のスクリプトを動かす前には、そのコードに必要なモジュールや権限、ファイルを変更する範囲を別途確認してください。