Windows 10/11でVisual Studio Codeを使ってPowerShellスクリプトを作成・実行する方法

Windows 10やWindows 11でも、PowerShellスクリプトを作成できることをご存じでしょうか?WindowsにPowerShellをインストールしたら、次はPCで何ができるのか知りたくなるはずです。このガイドでは、Visual Studio Codeを使ってシンプルなスクリプトファイルを作成し、Windows 10およびWindows 11のPowerShellで実行する方法を解説します。

まずは基本的なPowerShellスクリプトの作り方を覚えましょう。これをマスターすれば、Windows 10とWindows 11の両方でスクリプトを作成・実行できるようになり、作業効率が向上し、生産性アップにもつながります。

Windows 10/11でPowerShellスクリプトを作成する方法

以前は、ほぼすべてのテキストエディタでスクリプトを作成できました。しかし現在、Microsoftが推奨しているのは、PowerShell拡張機能を組み合わせたVisual Studio Codeエディタの使用です。

Visual Studio Code(VS Code)は、デスクトップ上で動作する強力かつ軽量なソースコードエディタで、Windows、macOS、Linuxに対応しています。

VS Codeには、JavaScript、TypeScript、Node.jsのサポートが標準で搭載されています。さらに、C++、C#、Java、Python、PHP、Goなどの開発言語や、.NETやUnityといったランタイムに対応した豊富な拡張機能のエコシステムも利用できるのが魅力です。

このガイドでは、Windows 10でPowerShellスクリプトを作成するためにPCを準備する方法を中心に説明します。

VS Codeをインストールする

1. Windows向けのVS Codeインストーラーをダウンロードします
2. ダウンロードが完了したら、インストーラー(VSCodeUserSetup-{version}.exe)を実行してVS Codeをインストールします

または、Zipアーカイブ版をダウンロードして展開し、そこからVS Codeを実行することも可能です。

VS Codeのインストールが完了したら、PowerShellスクリプトを作成できるようにするため、PowerShell拡張機能をインストールする必要があります。

VS CodeにPowerShell拡張機能をインストールする

VS Codeを開いてPowerShell拡張機能をインストールする手順は以下の通りです。

1. VS Codeを起動します
2. 左側のペインから拡張機能(Extensions)をクリックします(矢印のアイコン)
3. 「PowerShell」を検索して選択します
4. インストール(Install)ボタンをクリックし、PowerShell(またはPowerShell Preview)拡張機能をVS Codeに追加します

以上の手順を完了すると、VS Codeを使ってWindows 10上でPowerShellスクリプトの作成を始められます。

今後、他の拡張機能をインストールしたい場合は、キーボードショートカットCtrl + Shift + XでVS Codeの拡張機能画面に直接移動できます。時間があれば、Ctrl + Shift + Pで呼び出せる「すべてのコマンドの表示」から、利用可能なその他のショートカットも確認しておくと便利です。

VS CodeでPowerShellスクリプトを作成する

スクリプトを作成する手順は以下の通りです。

1. VS Codeを開きます
2. ファイル(File)メニューをクリックし、新規ファイル(New File)を選択します。または、Ctrl + Nショートカットキーを使用します

3. 次に、再度ファイルメニューを開き、名前を付けて保存(Save As)を選択してファイル形式を変更します。ショートカットキーはCtrl + Shift + Sです
4. PC上の任意の場所とファイル名を指定し、「ファイルの種類」をPowerShellに変更します

5. 保存(Save)をクリックしてファイルを保存します

これでPowerShellスクリプトファイルが作成され、ファイル一覧には.ps1という拡張子を持つWindows PowerShellファイルとして表示されます。新しく作成した「TestScript」ファイルに、PowerShellで実行するコマンドを追加してみましょう。

1. 作成したファイルをVS Codeで開きます
2. 実行したい新しいスクリプトを記述するか、貼り付けます:
Write-Host "Hello world! I created a PowerShell script!"
このスクリプトを実行すると、「Hello world! I created a PowerShell script!」という文字列が出力されます
3. (任意)右上の実行(Run)ボタンをクリックするか、F5キーを押すと、統合されたPowerShellウィンドウ内でスクリプトが実行され、下に出力結果が表示されます

4. 完了したら、ファイル(File)メニューから保存(Save)をクリックしてファイルを保存します

PowerShellでWindowsの実行ポリシーを変更する

VS Codeでの作業が完了すると、PowerShellスクリプトを実行する準備が整います。しかし、スクリプトファイルを実行する前に、Windows 10の実行ポリシーを変更する必要があります。デフォルト設定では、PowerShellでのスクリプト実行は許可されていないためです。

変更手順は以下の通りです。

1. PowerShellを開き、管理者として実行します
2. PowerShellスクリプトの実行を許可するため、以下のコマンドをコピーして貼り付けます:
Set-ExecutionPolicy RemoteSigned
3. Enterキーを押してコマンドを実行します
4. Aと入力してEnterキーを押します

これでPowerShellにおけるWindows 10の実行ポリシーが変更されたので、いよいよPowerShellスクリプトを実行しましょう。
1. PowerShellを開き、管理者として実行します
2. 作成したPowerShellスクリプトファイルのパスを貼り付けます
C:\Users\DAVE\Downloads\TestScript.ps1
3. Enterキーを押してスクリプトを実行します

以上の手順を完了すると、PowerShellスクリプトが実行されます。スクリプトが正しく書かれていれば、PowerShellに出力結果が表示されるはずです。

Windows 10/11に関するその他のリソース

Windows 10に関する役立つ記事、特集、よくある質問への回答については、以下のOnMSFTリソースをご覧ください。

OnMSFTのWindows 10ページ - 知っておくべきことすべて

OnMSFTのWindows 11ページ - 知っておくべきことすべて

OnPodcast:YouTubeで配信中のOnMSFT公式ポッドキャスト

Windows 10やWindows 11の便利なTipsや裏技についてのご提案があれば、ぜひコメント欄でお知らせください!