Skip to content

v2.0

Choose a tag to compare

@github-actions github-actions released this 15 Aug 09:32
· 6 commits to master since this release

The last SQL-Server-only release. The next change introduces SQLite. If you want to keep running against SQL Server and not follow that migration, stop here — this version is complete and supported as-is.

Requirements

  • Windows
  • PowerShell 7.6 or later. This is a hard floor: 7.6 is the first PowerShell release built on .NET 10, and an earlier pwsh cannot load a net10.0 assembly.
  • .NET 10 Desktop Runtime (Microsoft.WindowsDesktop.App), which the Windows Forms cmdlets need. If Import-Module fails complaining about a missing framework, install it from https://dotnet.microsoft.com/download/dotnet/10.0
  • SQL Server 2017

Breaking change: Windows PowerShell 5.1 is no longer supported

The powershell.exe that ships with Windows runs on .NET Framework and cannot load this module at all. Use pwsh.

If you cannot move to PowerShell 7, stay on v2026.08.15.2 — the last release that loads under 5.1.

Install

Unpack ImageStore-v2.0.zip into a folder as a whole. The module now ships with its dependency tree, and the files beside ImageStore.dll are not optional.

pwsh
Import-Module .\ImageStore.dll

ImageStore-Database-v2.0.zip is a separate download holding an empty database and the schema script. You only need it once, when setting up a new project; its contents are identical in every release.

Note: Select-ImageStoreSameFile and Resolve-ImageStoreSimilarFiles open windows, which requires a single-threaded apartment. pwsh provides one by default; VS Code's PowerShell Integrated Console does not, so run those two from a real console.

What changed

Upgraded from .NET Framework 4.8.1 to .NET 10, keeping Windows Forms. The database layer is deliberately unchanged.

  • System.Data.SqlClientMicrosoft.Data.SqlClient
  • The vendored phash fork is replaced by the upstream Shipwreck.Phash package, which now carries the overloads the fork existed for
  • SHA1ManagedSHA1.Create(), Assembly.CodeBaseAppContext.BaseDirectory

This is a large framework change. It builds clean and the package contents are verified, but if something misbehaves in your library, v2026.08.15.2 remains available and unaffected.