Update PS Requirement, CI Workflows, and Docs (#9715)

Author: potatoqualitee

.github/dbatools-library-version.json

@@ -1,4 +1,4 @@
 {
-  "version": "2025.7.19-preview-freshold-20250719213145",
+  "version": "2025.7.20",
   "notes": "Version of dbatools.library to use for CI/CD and development"
 }

.github/workflows/integration-tests.yml

@@ -43,11 +43,12 @@ jobs:
           Write-Output "Preview version detected, bypassing PSModuleCache and using install script"
           ./.github/scripts/install-dbatools-library.ps1
 
-      - name: Set encryption values
+      - name: Check file health and set encryption values
         run: |
           Import-Module ./dbatools.psd1 -Force
-          (Get-Module dbatools.library).Path | Write-Warning
-          Get-ChildItem /home/runner/.local/share/powershell/Modules/dbatools.library/core/lib/dac/linux | Write-Warning
+          Get-Module dbatools.library | Select-Object -ExpandProperty Path -OutVariable lib | Write-Warning
+          $lib = Split-Path -Path $lib -Parent
+          Get-ChildItem (Join-Path $lib -ChildPath core/lib/dac/linux) | Write-Warning
           Set-DbatoolsConfig -FullName sql.connection.trustcert -Value $true -Register
           Set-DbatoolsConfig -FullName sql.connection.encrypt -Value $false -Register
           Get-DbatoolsConfigValue -FullName sql.connection.encrypt | Write-Warning

.github/workflows/xplat-import.yml

@@ -15,6 +15,10 @@ jobs:
     steps:
     - uses: actions/checkout@v3
 
+    - name: Show pwsh version
+      shell: pwsh
+      run: pwsh --version
+
     - name: Read dbatools.library version
       id: get-version
       shell: pwsh

dbatools.psm1

@@ -75,9 +75,9 @@ If ($PSVersionTable.PSEdition -in "Desktop", $null) {
 }
 Write-ImportTime -Text "Checking for .NET"
 
-# Core needs to be at least 7.4.5
-if ($PSVersionTable.PSEdition -eq 'Core' -and $PSVersionTable.PSVersion.Major -lt 7 -and $PSVersionTable.PSVersion.Minor -lt 4 -and $PSVersionTable.PSVersion.Build -lt 5) {
-    throw "dbatools requires at least PowerShell 7.4.5 when running on Core. Please update your PowerShell."
+# Core needs to be at least 7.4.0
+if ($PSVersionTable.PSEdition -eq 'Core' -and $PSVersionTable.PSVersion -lt [version]"7.4.0") {
+    throw "dbatools requires at least PowerShell 7.4.0 when running on Core. Please update your PowerShell."
 }
 
 

readme.md

@@ -18,15 +18,15 @@ _Need an invite to the SQL Community Slack workspace? Check out the [self-invite
 
 ## Installer
 
-dbatools works on Windows, Linux and macOS (M1 and Intel!) 🤩👍 Windows requires PowerShell v3 and above, while those using dbatools on PowerShell Core will need to be running 7.3 and above.
+dbatools works on Windows, Linux and macOS (M1 and Intel!) 🤩👍 Windows requires PowerShell v3 and above, while those using dbatools on PowerShell Core will need to be running 7.4.0 and above.
 
 Run the following command to install dbatools from the PowerShell Gallery (to install on a server or for all users, remove the `-Scope` parameter and run in an elevated session):
 
 ```powershell
 Install-Module dbatools -Scope CurrentUser
 ```
 
-If you use an earlier version of PowerShell that does not support the PowerShell Gallery, you can download `PowerShellGet` from [Microsoft's site](https://learn.microsoft.com/en-us/powershell/scripting/gallery/installing-psget?view=powershell-7.3) then run the command again.
+If you use an earlier version of PowerShell that does not support the PowerShell Gallery, you can download `PowerShellGet` from [Microsoft's site](https://learn.microsoft.com/en-us/powershell/scripting/gallery/installing-psget?view=powershell-7.4) then run the command again.
 
 ## Usage scenarios
 
@@ -41,7 +41,7 @@ In addition to the simple things you can do in SSMS (e.g. starting a job, backin
 
 As previously mentioned, dbatools now offers [over 700 commands](https://dbatools.io/commands)! [Here are some of the ones we highlight at conferences](https://gist.github.com/potatoqualitee/e8932b64aeb6ef404e252d656b6318a2).
 
-PowerShell v3 and above required. (See below for important information about alternative logins and specifying SQL Server ports).
+PowerShell v3 and above required for Windows PowerShell, PowerShell Core 7.4.0+ required for cross-platform. (See below for important information about alternative logins and specifying SQL Server ports).
 
 ```powershell
 # Set some vars
@@ -248,7 +248,7 @@ Stop-Transcript
 
 dbatools aims to support as many configurations as possible, including
 
-* PowerShell v3 and above
+* PowerShell v3 and above (Windows PowerShell) or PowerShell Core 7.4.0+ (cross-platform)
 * Windows, macOS and Linux
 * SQL Server 2000 - Current
 * Express - Datacenter Edition