PowerShell ISE を卒業して VS Code を使い始めた話
こんにちは、多田です。
Microsoft 365 の設定作業では、Exchange Online や Microsoft Graph の PowerShell モジュールをよく使います。
これまでは、foreach を使う処理や複数行にまたがるスクリプトは PowerShell ISE のスクリプトウィンドウで書いて、少し直しては実行する、という使い方をよくしてきました。
いつからか、モジュールのバージョンを上げたところ、ISE からサインインできなくなりました。原因を調べた結果、作業環境を VS Code に移した方が良いのだろうなと感じましたので、その経緯をまとめておきます。
起きたこと
だいぶ前だったはずですが、ExchangeOnlineManagement モジュールを更新した後、いつものように接続しようとすると次のエラーで止まるようになりました。

PS C:\WINDOWS\system32> Connect-ExchangeOnline -UserPrincipalName adminaoimori01@uaoimori2020.onmicrosoft.com
A window handle must be configured. See https://aka.ms/msal-net-wam#parent-window-handles
発生場所 D:\Data\Document\WindowsPowerShell\Modules\ExchangeOnlineManagement\3.11.1\netFramework\ExchangeOnlineManagement.psm1:622 文字:21
+ throw $_.Exception.InnerException;
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : OperationStopped: (:) [], MsalClientException
+ FullyQualifiedErrorId : A window handle must be configured. See https://aka.ms/msal-net-wam#parent-window-handles
サインイン画面すら表示されず、その先の作業に進めません。以前のバージョンでは同じ手順で問題なく接続できていました。
原因は WAM と ISE の相性のよう
ExchangeOnlineManagement モジュールは、バージョン 3.7.0(2024年12月公開)からサインインに WAM(Web Account Manager、Windows のアカウント管理の仕組み)を使うようになったみたいです。
WAM は、サインイン画面が他のウィンドウの裏に隠れないように、親ウィンドウを指定することを求めます。ところがモジュール側の親ウィンドウの取得方法はコンソール前提のため、ISE のような環境では取得できず、このエラーになります。
※実際、特定のパラメーターを付ければ回避できるみたいですが、これを機に作業環境そのものを見直してみることにしました。
コンソールへのコピペ、直打ち運用も不便だった
それからは ISE とはほぼ疎遠となり、予め用意したスクリプトを PowerShell のコンソールにコピペするスタイルをなんとなく続けていました。ただ、このやり方にも不便な点がありました。
- スクリプト内容を少し変えるたびに、エディターでで直しては貼り直す往復が発生する
- 右クリックで貼り付けると、環境によっては1行ずつ実行されてしまう
- 手で入力しながら複数行を書くときは Shift + Enter を意識する必要がある
- 構文の色分けや入力補完が弱く、括弧の閉じ忘れなどのミスに気づきにくい
短いコマンドならコンソールで十分ですが、「書いて、少し直して、実行する」を繰り返す作業には向いていませんでした。
とりあえず ISE の代わりに VS Code
ISE はもう新機能が追加されておらず、Microsoft も PowerShell のスクリプトを書くエディターとしては VS Code と PowerShell 拡張機能を勧めています(Microsoft Learn)。
認証まわりの仕組みも今後また変わりそうなので、いい機会だと思って、複数行の処理やちょっとした調整は VS Code でやるようにし始めました。
長らく ISE に慣れ親しんできたので、ちょっとした使いづらさはあると思いますが、それでも使っていればそのうち手に馴染むはずなので、頑張って慣れていこうと思います。
普段から VS Code を使っている方は慣れるだけですが、ISE と違って VS Code は本体と PowerShell 拡張機能のインストールが必要な点もポイントです。ちょっとしたことならコンソール版でいいと思う人もいるかもしれませんね。
最後までご覧いただきありがとうございました。