できない.dev

PowerShell を 7.4 から 7.6 に上げると動かなくなること

PowerShell を 7.4 から 7.6 に上げると、ThreadJob モジュールの改名で #Requires に旧名を書いたスクリプトが起動しなくなり、-Debug を付けた Remove-Item は確認なしでファイルを消す。
7.4 と 7.6 で打ち比べた 7 つの変更点と直し方をまとめる。

公開:

Ubuntu 24.04 のコンテナに公式の tar.gz から PowerShell 7.4 と 7.6 を別々に展開し、pwsh7.4 と pwsh7.6 の名前で呼び分けて同じスクリプトを実行した。
手元では、どちらも pwsh と読み替える。
土台の .NET は、7.4 が 8、7.6 が 10 だった(検証環境の版を参照)。
各節の出力は「v7.4 では」「v7.6 に上げると」「v7.6 で直すと」の 3 段で並ぶ。

7.4 と 7.6 はどちらも LTS(長期サポート版)である。
Microsoft のサポートライフサイクルの表によると、7.4 のサポートは 2026 年 11 月 10 日に終わった。

間の 7.5 を飛ばして 7.6 に上げる人に向けて、7.5 で入った変更もここに含めている。

ThreadJob と -ExecutionPolicy の 2 つは、スクリプトが起動せずに止まる。
[semver] は、このページのように ForEach-Object の中で変換すると、エラーを出しながら処理が進んで違う答えを返す。
残りの 4 つは、変わったコマンド自身はエラーを出さない。
4 つのうち -Debug は、ファイルを消す操作に効く。
7.4 の Remove-Item は -Debug を付けると消す前に確認を求めたが、7.6 は確認なしで消す。

What's New と CHANGELOG が挙げる次の変更は、このページでは打っていない。
Windows だけで起きる変更は、Linux のコンテナでは打てない。

  • New-FileCatalog の -CatalogVersion の既定が 2 になった(Windows だけのコマンドレット)。
  • Windows のインストーラーが、前回のインストールで選んだ設定を覚えるようになった。
  • 制限付きのリモートセッションで、ネットワーク上の場所からヘルプを取れなくなった。
  • Windows のイベントログに書くイベントソース名から、末尾の空白が消えた。
  • Windows のネイティブの実行ファイルに渡す ~ を展開するようになった(PSNativeWindowsTildeExpansion が正式な機能になった)。

次の 3 つはどの OS でも起きる。
公式の項目は、どれも 7.4 の不具合の修正か、受け付ける値を広げる変更なので、このページの変更点には入れていない。

  • Join-Path の -ChildPath が、文字列の配列を受け取るようになった。
  • Test-Path に -PathType と -OlderThan・-NewerThan を一緒に渡したときの不具合が直った。
    What's New によると、7.4 では -OlderThan が無視されていた。
  • [WildcardPattern]::Escape() が、単独のバッククォートもエスケープするようになった。

次の 1 つは、CHANGELOG が Breaking Changes に挙げているが、既定の設定では起きない。

  • ConvertTo-Json に、long・ulong を元にした enum を数値で書く機能が入った(#20999)。
    What's New 7.6 では実験的な機能(PSSerializeJSONLongEnumAsNumber)のままで、about_Experimental_Features によると実験的な機能は既定で無効である。

ThreadJob モジュールの名前が変わった

Start-ThreadJob を含む ThreadJob モジュールは、7.6 で Microsoft.PowerShell.ThreadJob に名前が変わった。
コマンド名の Start-ThreadJob は変わらない。
What's New が影響として挙げるのは ThreadJob\Start-ThreadJob のようにモジュール名を付けた呼び出しだけだが、#Requires -Modules ThreadJob を書いたスクリプトも起動しなくなる。
CHANGELOG によると、7.6.0-preview.4 では互換用の ThreadJob 2.1.0 も同梱していたが、7.6.0-preview.5 で外した(#26120)。
検証した 7.6.10 にも、旧名のモジュールは入っていなかった。

v7.4 では

$ cat jobs.ps1
#Requires -Modules ThreadJob
$job = ThreadJob\Start-ThreadJob { 'done in a thread job' }
$job | Receive-Job -Wait -AutoRemoveJob
$ pwsh7.4 jobs.ps1
done in a thread job
$ echo $?
0
$ pwsh7.4 -c "Get-Command Start-ThreadJob | Format-List Name, Source, Version"
Name    : Start-ThreadJob
Source  : ThreadJob
Version : 2.0.3

v7.6 に上げると

$ pwsh7.6 jobs.ps1
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..
$ echo $?
1
$ pwsh7.6 -c "Get-Command Start-ThreadJob | Format-List Name, Source, Version"
Name    : Start-ThreadJob
Source  : Microsoft.PowerShell.ThreadJob
Version : 2.2.0
$ pwsh7.6 -c 'ThreadJob\Start-ThreadJob { 1 }'
ThreadJob\Start-ThreadJob: The module 'ThreadJob' could not be loaded. For more information, run 'Import-Module ThreadJob'.
$ echo $?
1

v7.6 で直すと

$ cat jobs.ps1
#Requires -Modules Microsoft.PowerShell.ThreadJob
$job = Microsoft.PowerShell.ThreadJob\Start-ThreadJob { 'done in a thread job' }
$job | Receive-Job -Wait -AutoRemoveJob
$ pwsh7.6 jobs.ps1
done in a thread job
$ echo $?
0
$ pwsh7.4 jobs.ps1
ResourceUnavailable: The script 'jobs.ps1' cannot be run because the following modules that are specified by the "#requires" statements of the script are missing: Microsoft.PowerShell.ThreadJob.
$ echo $?
1
$ pwsh7.4 -c "Install-PSResource -Name Microsoft.PowerShell.ThreadJob -Version 2.2.0 -TrustRepository"
$ echo $?
0
$ pwsh7.4 -c "Get-InstalledPSResource -Name Microsoft.PowerShell.ThreadJob | Format-List Name, Version"
Name    : Microsoft.PowerShell.ThreadJob
Version : 2.2.0
$ pwsh7.4 jobs.ps1
done in a thread job
$ echo $?
0
$ cat jobs.ps1
#Requires -Modules ThreadJob
$job = ThreadJob\Start-ThreadJob { 'done in a thread job' }
$job | Receive-Job -Wait -AutoRemoveJob
$ pwsh7.6 -c "Install-PSResource -Name ThreadJob -Version 2.1.0 -TrustRepository"
$ echo $?
0
$ pwsh7.6 -c "Get-InstalledPSResource -Name ThreadJob | Format-List Name, Version"
Name    : ThreadJob
Version : 2.1.0
$ pwsh7.6 jobs.ps1
WARNING: The ThreadJob module has been renamed to Microsoft.PowerShell.ThreadJob. The ThreadJob module will no longer be included with PowerShell as of 7.6 and above.
done in a thread job
$ echo $?
0

#Requires とモジュール名つきの呼び出しを、Microsoft.PowerShell.ThreadJob に書き換える。
7.4 にはこの名前のモジュールが入っていないので、書き換えたスクリプトはそのままでは 7.4 で起動しない。

7.4 と 7.6 の両方で同じスクリプトを動かすなら、7.4 にも PowerShell Gallery から Microsoft.PowerShell.ThreadJob 2.2.0 を Install-PSResource で入れる。
7.6 に入っているのと同じ版で、入れたあとは書き換えたスクリプトが 7.4 でも動いた。

人から受け取ったスクリプトのように書き換えられないなら、7.6 に Gallery の ThreadJob 2.1.0 を入れる。
CHANGELOG によると、これは Microsoft.PowerShell.ThreadJob に処理を渡す互換用のモジュールで、Gallery のページは非推奨(deprecated)としている。
読み込むと、改名を知らせる警告が出る。

-Debug を付けても実行前の確認が出なくなった

7.4 では、Remove-Item に -Debug を付けると、消す前に確認(ShouldProcess)を求めた。
7.6 ではこれが不具合として直され、-Debug を付けても確認を出さずにそのまま消す(#26081)。

コンテナには端末が無いので、-NonInteractive で走らせた。
7.4 は確認のために入力を読もうとして、非対話モードでは読めないというエラーで止まり、ファイルは残った。
7.6 は同じコマンドを終了コード 0 で終え、ファイルは消えていた。

v7.4 では

$ ls
old.txt
$ pwsh7.4 -NonInteractive -c "Remove-Item old.txt -Debug"
Remove-Item: PowerShell is in NonInteractive mode. Read and Prompt functionality is not available.
$ echo $?
1
$ ls
old.txt

v7.6 に上げると

$ pwsh7.6 -NonInteractive -c "Remove-Item old.txt -Debug"
$ echo $?
0
$ ls

v7.6 で直すと

$ pwsh7.6 -NonInteractive -c "Remove-Item old.txt -WhatIf"
What if: Performing the operation "Remove File" on target "/app/debug-no-confirm/old.txt".
$ pwsh7.6 -NonInteractive -c "Remove-Item old.txt -Confirm"
Remove-Item: PowerShell is in NonInteractive mode. Read and Prompt functionality is not available.
$ echo $?
1
$ ls
old.txt

-Debug を付けて確認を挟んでから消していたなら、7.6 では -Confirm を付ける。
-Confirm は 7.6 でも確認を求めるので、非対話モードでは 7.4 の -Debug と同じエラーで止まり、ファイルは残った。
何が消えるかを先に見るだけなら、-WhatIf を付ける。

Select-String の LineNumber が UInt64 になった

Select-String が返す一致の LineNumber は、7.4 では Int32 だったが、7.5 から UInt64 になった(#24075)。
PR の説明によると、とても長いファイルで行番号が負の数になるのを防ぐための変更である。

値は同じでも型が違うので、行番号をハッシュテーブルのキーにすると、スクリプトに書いた 2 のような Int32 の数では引けなくなる。
エラーは出ず、空の値が返る。

v7.4 では

$ cat hits.ps1
$hits = @{}
Select-String -Path app.log -Pattern ERROR | ForEach-Object { $hits[$_.LineNumber] = $_.Line }
"line 2: $($hits[2])"
"line 4: $($hits[4])"
$ pwsh7.4 hits.ps1
line 2: ERROR disk full
line 4: ERROR timeout
$ pwsh7.4 -c "(Select-String -Path app.log -Pattern ERROR)[0].LineNumber.GetType().FullName"
System.Int32

v7.6 に上げると

$ pwsh7.6 hits.ps1
line 2: 
line 4:
$ pwsh7.6 -c "(Select-String -Path app.log -Pattern ERROR)[0].LineNumber.GetType().FullName"
System.UInt64

v7.6 で直すと

$ cat hits.ps1
$hits = @{}
Select-String -Path app.log -Pattern ERROR | ForEach-Object { $hits[[int]$_.LineNumber] = $_.Line }
"line 2: $($hits[2])"
"line 4: $($hits[4])"
$ pwsh7.6 hits.ps1
line 2: ERROR disk full
line 4: ERROR timeout

キーに入れる前に [int] で Int32 に戻す。
行番号が Int32 の上限(2147483647)を超えるほど長いファイルでなければ、[int] に戻しても値は同じである。

ConvertTo-Json が BigInteger を数値で書くようになった

ConvertFrom-Json は、Int64 の上限を超える 12345678901234567890 を BigInteger として読んだ。
7.4 の ConvertTo-Json は BigInteger を数値として書けず、IsPowerOfTwo などのプロパティを並べたオブジェクトにした。
そのため、JSON を読んで 1 項目だけ書き換えて書き戻すと、id が別のものに置き換わった。
7.5 からは数値のまま書く(What's New 7.5 の Breaking Changes)。

v7.4 では

$ cat data.json
{"id":12345678901234567890,"name":"a"}
$ cat update.ps1
$o = Get-Content data.json | ConvertFrom-Json
$o.name = 'b'
$o | ConvertTo-Json -Compress
$ pwsh7.4 update.ps1
{"id":{"IsPowerOfTwo":false,"IsZero":false,"IsOne":false,"IsEven":true,"Sign":1},"name":"b"}
$ pwsh7.4 -c "(Get-Content data.json | ConvertFrom-Json).id.GetType().FullName"
System.Numerics.BigInteger

v7.6 に上げると

$ pwsh7.6 update.ps1
{"id":12345678901234567890,"name":"b"}

v7.6 で直すと

$ cat update.ps1
$o = Get-Content data.json | ConvertFrom-Json
$o.name = 'b'
$o.id = [string]$o.id
$o | ConvertTo-Json -Compress
$ pwsh7.6 update.ps1
{"id":"12345678901234567890","name":"b"}

7.6 では書き戻しても id が変わらない。
数値のままでは正確に読めない相手に渡すなら、書き出す前に [string] で文字列にしておく。
たとえば JavaScript の Number は 2 の 53 乗を超える整数を正確に表せない(JavaScript 側はこのページでは打っていない)。

[semver] が rc.01 のような先頭が 0 の番号を受け付けなくなった

[semver](SemanticVersion)は、7.5 から semver.org の規則どおりに文字列を検査する(#21401)。
semver.org の規則では、プレリリースの数字だけの部分に先頭の 0 を付けられない。
7.4 は 2.2.0-rc.01 を受け付けたが、7.6 は変換できずにエラーを出す。

ForEach-Object の中の変換エラーは処理を止めないので、スクリプトは rc.01 と rc.02 を飛ばして続き、最新版を 2.1.0 と答えた。
終了コードも 0 のままである。
エラー文の The input string '' は空の文字列を渡したように読めるが、渡したのは 2.2.0-rc.01 である。

v7.4 では

$ cat latest.ps1
$tags = 'v2.1.0', 'v2.2.0-rc.01', 'v2.2.0-rc.02'
$latest = $tags | ForEach-Object { [semver]$_.TrimStart('v') } | Sort-Object | Select-Object -Last 1
"latest: $latest"
$ pwsh7.4 latest.ps1
latest: 2.2.0-rc.02
$ echo $?
0
$ pwsh7.4 -c '[semver]"2.2.0-rc.01"'
Major  Minor  Patch  PreReleaseLabel BuildLabel
-----  -----  -----  --------------- ----------
2      2      0      rc.01
$ echo $?
0

v7.6 に上げると

$ pwsh7.6 latest.ps1
InvalidArgument: /app/semver-leading-zero/latest.ps1:2
Line |
   2 |  $latest = $tags | ForEach-Object { [semver]$_.TrimStart('v') } | Sort …
     |                                     ~~~~~~~~~~~~~~~~~~~~~~~~~
     | Cannot convert value "2.2.0-rc.01" to type
     | "System.Management.Automation.SemanticVersion". Error: "The input string
     | '' was not in a correct format."
InvalidArgument: /app/semver-leading-zero/latest.ps1:2
Line |
   2 |  $latest = $tags | ForEach-Object { [semver]$_.TrimStart('v') } | Sort …
     |                                     ~~~~~~~~~~~~~~~~~~~~~~~~~
     | Cannot convert value "2.2.0-rc.02" to type
     | "System.Management.Automation.SemanticVersion". Error: "The input string
     | '' was not in a correct format."
latest: 2.1.0
$ echo $?
0
$ pwsh7.6 -c '[semver]"2.2.0-rc.01"'
InvalidArgument: Cannot convert value "2.2.0-rc.01" to type "System.Management.Automation.SemanticVersion". Error: "The input string '' was not in a correct format."
$ echo $?
1

v7.6 で直すと

$ cat latest.ps1
$tags = 'v2.1.0', 'v2.2.0-rc.01', 'v2.2.0-rc.02'
$latest = $tags | ForEach-Object { [semver]($_.TrimStart('v') -replace '\.0+(?=\d)', '.') } | Sort-Object | Select-Object -Last 1
"latest: $latest"
$ pwsh7.6 latest.ps1
latest: 2.2.0-rc.2
$ echo $?
0

タグを自分で付けているなら、rc.1 のように先頭の 0 を付けない。
外から来た文字列を読むなら、変換の前に先頭の 0 を取り除く。
ここでは -replace '\.0+(?=\d)', '.' で、. の直後に続く 0 を消した。
取り除いたぶん、表示は 2.2.0-rc.2 になる。

pwsh の -ExecutionPolicy に無効な値を渡すと起動しなくなった

7.4 の pwsh は、-ExecutionPolicy に無効な値を渡しても何も言わずにスクリプトを実行した。
ここでは Bypass を打ち間違えた Bypas を渡した。
7.5 からは値を検査し、使い方を表示して終了コード 64 で終わる(#20460)。
打ったのは Linux の pwsh だけで、Windows では打っていない。

v7.4 では

$ pwsh7.4 -ExecutionPolicy Bypas -File hello.ps1
hello
$ echo $?
0

v7.6 に上げると

$ pwsh7.6 -ExecutionPolicy Bypas -File hello.ps1
Invalid ExecutionPolicy value 'Bypas'.
 
Usage: pwsh[.exe] [-Login] [[-File] <filePath> [args]]
                  [-Command { - | <script-block> [-args <arg-array>]
                                | <string> [<CommandParameters>] } ]
                  [-CommandWithArgs <string> [<CommandParameters>]
                  [-ConfigurationName <string>] [-ConfigurationFile <filePath>]
                  [-CustomPipeName <string>] [-EncodedCommand <Base64EncodedCommand>]
                  [-ExecutionPolicy <ExecutionPolicy>] [-InputFormat {Text | XML}]
                  [-Interactive] [-MTA] [-NoExit] [-NoLogo] [-NonInteractive] [-NoProfile]
                  [-NoProfileLoadTime] [-OutputFormat {Text | XML}]
                  [-SettingsFile <filePath>] [-SSHServerMode] [-STA]
                  [-Version] [-WindowStyle <style>]
                  [-WorkingDirectory <directoryPath>]
 
       pwsh[.exe] -h | -Help | -? | /?
 
PowerShell Online Help https://aka.ms/powershell-docs
 
All parameters are case-insensitive.
$ echo $?
64

v7.6 で直すと

$ pwsh7.6 -ExecutionPolicy Bypass -File hello.ps1
hello
$ echo $?
0

Bypass と正しく書けば、7.6 でも実行できる。
CI の設定やショートカットに書いた -ExecutionPolicy の値は、7.6 に上げる前に見直す。
7.4 では打ち間違えたまま気づかずに動いていた可能性がある。

New-Item の -Target がワイルドカードを展開しなくなった

7.4 の New-Item -ItemType SymbolicLink は、-Target に渡した app-*.log をワイルドカードとして展開し、一致したファイルの絶対パスをリンク先にした。
7.6 は -Target を書いたままの文字列として扱う(#25186)。
PR の説明によると、名前にワイルドカードの文字を含むファイルへリンクを張れない、または違う場所を指すリンクができる不具合を直すための変更である。

app-*.log という名前のファイルは無いので、7.6 のリンクは存在しない先を指す。
New-Item はエラーを出さず、続く Get-Content で初めてファイルが見つからないというエラーになった。
スクリプトの終了コードは 0 のままである。

v7.4 では

$ ls
app-20261101.log
link.ps1
$ cat link.ps1
New-Item -ItemType SymbolicLink -Path latest.log -Target app-*.log | Out-Null
(Get-Item latest.log).Target
Get-Content latest.log
$ pwsh7.4 link.ps1
/app/new-item-target-literal/app-20261101.log
log of 2026-11-01
$ echo $?
0

v7.6 に上げると

$ pwsh7.6 link.ps1
app-*.log
Get-Content: /app/new-item-target-literal/link.ps1:3
Line |
   3 |  Get-Content latest.log
     |  ~~~~~~~~~~~~~~~~~~~~~~
     | Could not find file '/app/new-item-target-literal/latest.log'.
$ echo $?
0
$ ls -l latest.log
lrwxrwxrwx 1 root root 9 Nov 13 01:44 latest.log -> app-*.log

v7.6 で直すと

$ cat link.ps1
New-Item -ItemType SymbolicLink -Path latest.log -Target (Get-Item app-*.log).FullName | Out-Null
(Get-Item latest.log).Target
Get-Content latest.log
$ pwsh7.6 link.ps1
/app/new-item-target-literal/app-20261101.log
log of 2026-11-01
$ echo $?
0

ワイルドカードで探してリンクを張るなら、先に Get-Item で探し、見つかったファイルのパスを -Target に渡す。
ここでは .FullName で絶対パスを渡し、7.4 と同じリンク先にした。

検証環境PowerShell(旧) 7.4.22 / PowerShell(新) 7.6.10 / .NET(旧) 8.0.33 / 2026-11-13 検証(ほか 1 件)
検証日
実行環境
ubuntu:24.04 Ubuntu 24.04.5 LTS
バージョン
  • PowerShell(旧) 7.4.22
  • PowerShell(新) 7.6.10
  • .NET(旧) 8.0.33
  • .NET(新) 10.0.15

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。