PowerShell開発のためのVS Codeの設定:初心者ガイド

PowerShellスクリプトの作成を始めるには、適切なツールが必要であり、Visual Studio Code(VS Code)はPowerShell開発のための最高のエディターの1つです。

このチュートリアルでは、PowerShell用にVS Codeをダウンロードして設定し、ターミナルの構成、必須の拡張機能のインストール、およびVS Codeのパワフルな機能のいくつかを探索します。

一緒に進めて、最後まで行けば、PowerShellでスクリプトを作成する準備が整った環境を手に入れるでしょう。

VS Codeのダウンロードとインストール

さあ、真剣に取り組んで実際の作業をしましょう!しかし、まずはVS Codeエディターをダウンロードしましょう。

VS Codeをダウンロードしてインストールするには、以下を行います:

1. お気に入りの検索エンジンでVS Codeを検索し、右上隅のダウンロードリンクをクリックします。

Accessing the VS Code download page

2. オペレーティングシステムとアーキテクチャ(x64またはArm64)を選択し、ダウンロードが完了するのを待ちます。

ここではWindows x64 システムインストーラーを選択します。このオプションを選ぶと、別のユーザーアカウントを使用する場合でもプロファイルの心配は不要です。

Picking an OS-compatible VS Code installer

3. ダウンロードが完了したら、インストールを開始してVS Codeを起動します。

Starting VS Code installation

これでVS Codeが手に入り、PowerShell開発のために構成する準備が整いました。

Overviewing VS Code

PowerShell用にVS Codeを構成する

VS Codeのデフォルトの画面サイズはほとんどの人に適していますが、必要に応じてVS Codeの表示を少し大きくすることができます。

VS Codeのナビゲーションに迷う前に、ますはそのユーザーインターフェースに慣れてください。

1. ウィンドウ全体を拡大または縮小する必要がある場合は、Ctrl+=およびCtrl+-を押します。

これでより良くなりました!

Zooming in and out

2. 次に、新しいタブを作成するには、Ctrl+Nを押し、VS Codeが作業言語を尋ねてくるのを確認します。

通常、VS Codeはこれを自動検出しますが、エディターウィンドウにコードがないため、わかりません。

Creating a new file

3. そこにいくつかのPowerShellコードを入力します。

Get-Service -Name 'wuauserv'

何も変わらないことに気づくでしょう。なぜでしょうか?VS Codeはこのコードをプレーンテキストとして扱い、まだPowerShellコードを理解していません。それを変えましょう。

Adding code in the editor

4. アクティビティバー(左端)の[拡張機能]アイコンをクリックし、PowerShellを検索して、拡張機能をインストールします。

VS Codeにはほとんど何でもできる拡張機能が数百あります。

[インストール]をクリックし、数秒待って、拡張機能がインストールされるはずです。

Searching and installing the PowerShell extension

VS Codeの機能を探る

拡張機能をインストールしたら、PowerShell開発のためのVS Codeの機能を探ることができます。他にも多くのオプションがありますが、これはPowerShellガイドであることを覚えておいてください。

1. 前のタブに戻り、PS1拡張子(PowerShellスクリプト用のファイル拡張子)でコードを保存します。

これを行った後、2つのことに気付きます: テキストの色が変わりました(構文のハイライトとして知られています)、そして下にPowerShellの端末が開きました。

  • 構文のハイライトは、特に大規模なスクリプトを書いているときにコードをより読みやすくします。
  • 下のPowerShellコンソール、端末ウィンドウは、VS Codeに統合された組み込みシェルであり、エディタを離れる必要はありません。
Confirming the changes to the editor and viewing the terminal

2. 簡単なコードを端末に貼り付けて、いくつかの機能をハイライトします。

$users = @{
'abertram' = 'Adam Bertram'
'bjoel' = 'Billy Joel'
'bbrown' = 'Bobby Brown'
}

echo "adbertram's full name is $($users['abertram'])"

`echo`の下に波線があることに注意してください。VS Codeは、より良いコードを書くのを支援します。

この場合、VS Codeは`echo`のエイリアスをハイライトし、明確にするために実際のコマンド名に変更するよう提案しています。

Confirming the highlighted command

3. 今、エイリアスにカーソルを合わせると、`Write-Output`を使用するよう指示が表示されます。

そこで、すぐに修正するためにQuick Fixをクリックします。

Demonstrating the Quick Fix feature

4. もう1つの機能はコードの折りたたみです。折りたたみ可能なコードにカーソルを合わせると、VS Codeは下矢印を表示します。

この矢印をクリックしてコードを折り畳んだり展開したりして、作業していないコードを非表示にできます。

Demonstrating collapsible code

5. 設定を調整したい場合は:
ファイルメニューに移動して→ 設定を選択します。
設定タブから、拡張機能を展開し、PowerShellを選択します。

  • ファイルメニューに移動して→ 設定を選択します。
  • 設定から、設定タブを展開し、拡張機能を選択し、PowerShellを選択します。

多くの調整や変更ができることがわかります。

Exploring the PowerShell extension settings

統合ターミナルの設定

最後に知っておくべきことが1つあります:ターミナルです。エディターの下にある統合ターミナルは、cmd.exe、PowerShell、Bashなどのシェルのようなものであり、VS Codeに直接統合されています。VS Codeの一部であるため、コードをテストするためにエディターを出る必要はありません。多くの利点が提供されます。

VS Codeは、PowerShellスクリプトを書く際にデフォルトのターミナルとしてWindows PowerShellを使用します。PowerShell Coreを使用しているため、VS CodeをWindows PowerShellの代わりにPowerShell Coreを使用するように設定する必要があります。

VS Codeを構成するには:

1. Ctrl+Shift+Pを押し、settingsと入力し、Preferences: Open User Settings (JSON)を見つけてクリックします。

このJSONファイルがエディターに開きます。VS CodeはバックグラウンドでJSONを使用しているため、変更を素早く行う方法です。

2. この場合、2つのエントリを持つ新しい統合プロファイルを作成し、PowerShell 7に設定する必要があります。

  • 統合プロファイルを作成し、それをPowerShell 7の実行可能ファイルに指定します。
  • デフォルトのプロファイルを作成したものに設定します。
"terminal.integrated.profiles.windows": {
"PowerShell Core": {
"path": ["C:\Program Files\PowerShell\7\pwsh.exe"],
"icon": "terminal-powershell"
}
},
"terminal.integrated.defaultProfile.windows": "PowerShell Core"

3. settings.jsonファイルを保存し、VS Codeを再度開きます。

4. 今、下部のターミナルをクリックして`$PSVersionTable`と入力して、VS Codeが使用しているPowerShellのバージョンを確認します。

PSVersion7.4.3PSEditionCoreと表示されるのを確認できます。

Verifying the PowerShell version used in VS Code’s terminal

ターミナルでPowerShellスクリプトを実行する

ターミナルは多くのことができますが、ウィンドウ内でコードを実行することが最も便利です。例えば、スクリプトを実行してテストしたい場合は、

スクリプトを調整して保存したら、F5キーを押してください。それにより、スクリプトが実行され、出力が直接下のターミナルに表示されます。

Running an entire script by pressing F5

しかし、一部だけを実行したい場合もあるかもしれません。その場合は、コードの一部をハイライトしてF8キーを押すことで、スクリプトのその部分のみを実行できます。

スクリプトの一部のみを実行できるこの機能は、より大きなスクリプトのトラブルシューティング時に便利です。

Running a specific part of the code

結論

これで、PowerShell開発用にVS Codeを設定し、その必須機能を探索しました。PowerShell拡張機能、統合ターミナル、便利な編集ツールを利用して、VS Code内で直接スクリプトの作成やトラブルシューティングを開始できます。

インターフェースに慣れてきたら、さらに設定や拡張機能を探索して、開発環境をカスタマイズできます。VS Codeは強力なエディタであり、多くのことができますが、初心者にとっては歩く前には這わなければなりません!

Source:
https://adamtheautomator.com/vs-code-powershell-setup/