できない.dev

PowerShell「The module 'ThreadJob' cannot be found」の原因と直し方

PowerShell 7.6 の The module 'ThreadJob' cannot be found は、モジュール名を書き換えれば直る。
7.6 で ThreadJob モジュールは Microsoft.PowerShell.ThreadJob に名前が変わった。

公開:

要約

PowerShell 7.6 で、7.4 まで動いていたスクリプトが次のエラーで起動しなくなることがある。

ResourceUnavailable: The script 'jobs.ps1' cannot be run because the following modules that are specified by the "#requires" statements of the script are missing: The module 'ThreadJob' cannot be found..

Start-ThreadJob を含む ThreadJob モジュールは、7.6 で Microsoft.PowerShell.ThreadJob に名前が変わった(What's New in PowerShell 7.6(新しいタブで開く))。
#Requires -Modules ThreadJob は旧名のモジュールを探すので、見つからずに止まる。
モジュール名を書き換えれば直る。

解決策

1. モジュール名を書き換える

#Requires -Modules Microsoft.PowerShell.ThreadJob
$job = Microsoft.PowerShell.ThreadJob\Start-ThreadJob { 'done in a thread job' }
$job | Receive-Job -Wait -AutoRemoveJob

Start-ThreadJob というコマンド名は変わっていないので、呼び出しはモジュール名を外して Start-ThreadJob とだけ書いてもよい。
7.6 の Get-Command Start-ThreadJob は、Microsoft.PowerShell.ThreadJob 2.2.0 のコマンドとしてこれを見つける。

2. 7.4 と 7.6 の両方で動かす

書き換えたスクリプトは、そのままでは 7.4 で起動しない。
7.4 には新しい名前のモジュールが入っていないためだ。

Install-PSResource -Name Microsoft.PowerShell.ThreadJob -Version 2.2.0 -TrustRepository

7.4 にも PowerShell Gallery から 7.6 と同じ版のモジュールを入れると、書き換えたスクリプトが 7.4 でも動いた。

3. 書き換えられないなら旧名の互換モジュールを入れる

人から受け取ったスクリプトのように書き換えられないなら、7.6 に Gallery の ThreadJob 2.1.0 を入れる。

Install-PSResource -Name ThreadJob -Version 2.1.0 -TrustRepository

入れたあとは、改名を知らせる WARNING の行が出たうえでスクリプトが動いた。
CHANGELOG によると、これは処理を Microsoft.PowerShell.ThreadJob に渡す互換用のモジュールで、Gallery のページは非推奨としている。
一時しのぎにとどめ、いずれは 1 の書き換えに移る。

よくある原因

  1. スクリプトの先頭に #Requires -Modules ThreadJob を書いている。
    7.6.10 には旧名のモジュールが入っていないので、スクリプトは 1 行も実行されずに終了コード 1 で終わる。
  2. ThreadJob\Start-ThreadJob のように、モジュール名を付けて Start-ThreadJob を呼んでいる。
    この場合は The module 'ThreadJob' could not be loaded. と出る。
    エラーはその行だけで、スクリプトは次の行へ進み、ジョブを受ける変数は空のままになる。
    What's New が影響として挙げるのは、こちらの書き方である。