Test allowing installing Preview versions of PowerShell

.github/workflows/Action-Test.yml

@@ -22,7 +22,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macOS-latest]
-        version: ['latest', '7.4.7', '7.5.0']
+        version: ['latest', 'preview', '7.4.7', '7.5.0']
     runs-on: ${{ matrix.os }}
     name: '${{ matrix.os }} - [${{ matrix.version }}]'
     steps:
@@ -34,7 +34,8 @@ jobs:
       - name: Action-Test
         uses: ./
         with:
-          Version: ${{ matrix.version }}
+          Version: ${{ matrix.version == 'preview' && 'latest' || matrix.version }}
+          Preview: ${{ matrix.version == 'preview' && 'true' || 'false' }}
 
       - name: Verify installed version
         shell: pwsh
@@ -44,8 +45,19 @@ jobs:
           # Requested version that came from the matrix
           $requested = '${{ matrix.version }}'
 
+          # When 'preview' → resolve to latest preview release
+          if ($requested.Trim().ToLower() -eq 'preview') {
+              $releases = Invoke-RestMethod -Uri 'https://api.github.com/repos/PowerShell/PowerShell/releases' `
+                -Headers @{
+                  'Accept' = 'application/vnd.github+json'
+                  'Authorization' = "Bearer $($env:GITHUB_TOKEN)"
+                  'X-GitHub-Api-Version' = '2022-11-28'
+                }
+              $requested = ($releases | Where-Object { $_.prerelease -eq $true } | Select-Object -First 1).tag_name.TrimStart('v')
+              Write-Host "Resolved 'preview' → $requested"
+          }
           # When empty / 'null' / 'latest' → resolve to latest stable release
-          if ([string]::IsNullOrWhiteSpace($requested) -or
+          elseif ([string]::IsNullOrWhiteSpace($requested) -or
               $requested.Trim().ToLower() -in @('latest','null')) {
 
               $requested = (
@@ -60,7 +72,14 @@ jobs:
           }
 
           # Actual version installed by the action
-          $installed = ($PSVersionTable.PSVersion).ToString()
+          if ($IsWindows) {
+              $majorVersion = ($requested -split '[\.-]')[0]
+              $installDir = if ($requested -match 'preview') { "$majorVersion-preview" } else { $majorVersion }
+              $installed = (& "$env:ProgramFiles\PowerShell\$installDir\pwsh.exe" -NoLogo -NoProfile -Command '$PSVersionTable.PSVersion.ToString()')
+          } else {
+              $installed = (pwsh -NoLogo -NoProfile -Command '$PSVersionTable.PSVersion.ToString()')
+          }
+
           Write-Host "Installed PowerShell version: $installed"
           Write-Host "Expected  PowerShell version: $requested"
 

README.md

@@ -1,12 +1,11 @@
 # Install-PowerShell
 
-A cross‑platform GitHub Action that installs a specific **PowerShell Core** version—or the latest stable release—on any GitHub‑hosted runner
+A cross‑platform GitHub Action that installs a specific **PowerShell Core** version—or the latest stable or preview release—on any GitHub‑hosted runner
 (Linux, macOS, or Windows). The action automatically skips installation when the requested version is already present.
 
 ## Usage
 
 Add the action to a job in your workflow file:
-
 ```yaml
 jobs:
   build:
@@ -25,11 +24,27 @@ jobs:
           Write-Host "Using PowerShell $($PSVersionTable.PSVersion)"
 ```
 
+### Installing preview builds
+
+```yaml
+      - name: Install PowerShell Preview
+        uses: PSModule/install-powershell@v1
+        with:
+          Version: latest
+          Preview: true
+
+      - name: Run a PowerShell script
+        shell: pwsh
+        run: |
+          Write-Host "Using PowerShell $($PSVersionTable.PSVersion)"
+```
+
 ## Inputs
 
 | Input | Required | Default | Description |
 | ----- | -------- | ------- | ----------- |
-| `Version` | `false` | `latest` | Desired PowerShell Core version (e.g. `7.4.1`). Use `latest` to install the newest stable release. |
+| `Version` | `false` | `latest` | Desired PowerShell Core version (e.g. `7.4.1`, `7.6.0-preview.1`). Use `latest` to install the newest stable release, or the newest preview release when `Preview` is `true`. |
+| `Preview` | `false` | `false` | Install PowerShell preview build instead of stable. When `true` and `Version` is `latest`, installs the latest preview release. |
 
 ## Secrets
 
@@ -43,7 +58,7 @@ This action does **not** generate any outputs.
 
 * **Version resolution**
   If `Version` is set to `latest` (case‑insensitive), the action queries the GitHub API for the newest stable release tag in the
-  `PowerShell/PowerShell` repository and substitutes that version.
+  `PowerShell/PowerShell` repository and substitutes that version. When `Preview` is `true`, it queries for the latest preview release instead.
 
 * **Skip logic**
   Before installing, the action checks the current runner to see whether the requested version is already available

action.yml

@@ -11,10 +11,17 @@ branding:
 inputs:
   Version:
     description: |
-      PowerShell version to install (e.g. `7.4.1`).
+      PowerShell version to install (e.g. `7.4.1` or `7.5.0-preview.1`).
       Defaults to install the latest stable release.
+      Use 'latest' for latest stable, or latest preview if Preview is true.
     required: false
     default: 'latest'
+  Preview:
+    description: |
+      Install PowerShell preview build instead of stable.
+      When true and Version is 'latest', installs the latest preview release.
+    required: false
+    default: 'false'
 
 runs:
   using: composite
@@ -25,24 +32,39 @@ runs:
       working-directory: ${{ github.action_path }}
       env:
         REQUESTED_VERSION: ${{ inputs.Version }}
+        PREVIEW: ${{ inputs.Preview }}
         GITHUB_TOKEN: ${{ github.token }}
       run: |
         # Install-PowerShell
         set -e
         echo "Requested version: [$REQUESTED_VERSION]"
+        echo "Preview mode: [$PREVIEW]"
 
         # Only resolve to latest version if explicitly set to 'latest' (case-insensitive)
         case "${REQUESTED_VERSION:-}" in
             [Ll][Aa][Tt][Ee][Ss][Tt])
-                REQUESTED_VERSION=$(
-                  curl -s -f \
-                    -H "Accept: application/vnd.github+json" \
-                    -H "Authorization: Bearer $GITHUB_TOKEN" \
-                    -H "X-GitHub-Api-Version: 2022-11-28" \
-                    https://api.github.com/repos/PowerShell/PowerShell/releases/latest |
-                    jq -r '.tag_name' | sed 's/^v//'
-                )
-                echo "Latest stable PowerShell release detected: $REQUESTED_VERSION"
+                if [[ "$PREVIEW" == "true" ]]; then
+                    echo "Fetching latest preview release..."
+                    REQUESTED_VERSION=$(
+                      curl -s -f \
+                        -H "Accept: application/vnd.github+json" \
+                        -H "Authorization: Bearer $GITHUB_TOKEN" \
+                        -H "X-GitHub-Api-Version: 2022-11-28" \
+                        https://api.github.com/repos/PowerShell/PowerShell/releases |
+                        jq -r '[.[] | select(.prerelease == true)] | .[0].tag_name' | sed 's/^v//'
+                    )
+                    echo "Latest preview PowerShell release detected: $REQUESTED_VERSION"
+                else
+                    REQUESTED_VERSION=$(
+                      curl -s -f \
+                        -H "Accept: application/vnd.github+json" \
+                        -H "Authorization: Bearer $GITHUB_TOKEN" \
+                        -H "X-GitHub-Api-Version: 2022-11-28" \
+                        https://api.github.com/repos/PowerShell/PowerShell/releases/latest |
+                        jq -r '.tag_name' | sed 's/^v//'
+                    )
+                    echo "Latest stable PowerShell release detected: $REQUESTED_VERSION"
+                fi
                 ;;
             "")
                 echo "Error: Version input is required (or use 'latest')"
@@ -99,24 +121,39 @@ runs:
       working-directory: ${{ github.action_path }}
       env:
         REQUESTED_VERSION: ${{ inputs.Version }}
+        PREVIEW: ${{ inputs.Preview }}
         GITHUB_TOKEN: ${{ github.token }}
       run: |
         # Install-PowerShell
         set -e
         echo "Requested version: [$REQUESTED_VERSION]"
+        echo "Preview mode: [$PREVIEW]"
 
         # Only resolve to latest version if explicitly set to 'latest' (case-insensitive)
         case "${REQUESTED_VERSION:-}" in
             [Ll][Aa][Tt][Ee][Ss][Tt])
-                REQUESTED_VERSION=$(
-                  curl -s -f \
-                    -H "Accept: application/vnd.github+json" \
-                    -H "Authorization: Bearer $GITHUB_TOKEN" \
-                    -H "X-GitHub-Api-Version: 2022-11-28" \
-                    https://api.github.com/repos/PowerShell/PowerShell/releases/latest |
-                    jq -r '.tag_name' | sed 's/^v//'
-                )
-                echo "Latest stable PowerShell release detected: $REQUESTED_VERSION"
+                if [[ "$PREVIEW" == "true" ]]; then
+                    echo "Fetching latest preview release..."
+                    REQUESTED_VERSION=$(
+                      curl -s -f \
+                        -H "Accept: application/vnd.github+json" \
+                        -H "Authorization: Bearer $GITHUB_TOKEN" \
+                        -H "X-GitHub-Api-Version: 2022-11-28" \
+                        https://api.github.com/repos/PowerShell/PowerShell/releases |
+                        jq -r '[.[] | select(.prerelease == true)] | .[0].tag_name' | sed 's/^v//'
+                    )
+                    echo "Latest preview PowerShell release detected: $REQUESTED_VERSION"
+                else
+                    REQUESTED_VERSION=$(
+                      curl -s -f \
+                        -H "Accept: application/vnd.github+json" \
+                        -H "Authorization: Bearer $GITHUB_TOKEN" \
+                        -H "X-GitHub-Api-Version: 2022-11-28" \
+                        https://api.github.com/repos/PowerShell/PowerShell/releases/latest |
+                        jq -r '.tag_name' | sed 's/^v//'
+                    )
+                    echo "Latest stable PowerShell release detected: $REQUESTED_VERSION"
+                fi
                 ;;
             "")
                 echo "Error: Version input is required (or use 'latest')"
@@ -160,23 +197,38 @@ runs:
       working-directory: ${{ github.action_path }}
       env:
         REQUESTED_VERSION: ${{ inputs.Version }}
+        PREVIEW: ${{ inputs.Preview }}
         GITHUB_TOKEN: ${{ github.token }}
       run: |
         # Install-PowerShell
         Write-Host "Requested version: [$env:REQUESTED_VERSION]"
+        Write-Host "Preview mode: [$env:PREVIEW]"
 
         # Resolve 'latest' → concrete version
         $req = $env:REQUESTED_VERSION
         if ($req -and $req.Trim().ToLower() -eq 'latest') {
-            $latest = (
-              Invoke-RestMethod -Uri 'https://api.github.com/repos/PowerShell/PowerShell/releases/latest' `
-              -Headers @{
-                'Accept' = 'application/vnd.github+json'
-                'Authorization' = "Bearer $($env:GITHUB_TOKEN)"
-                'X-GitHub-Api-Version' = '2022-11-28'
-              }
-            ).tag_name.TrimStart('v')
-            Write-Host "Latest stable PowerShell release detected: $latest"
+            if ($env:PREVIEW -eq 'true') {
+                Write-Host "Fetching latest preview release..."
+                $releases = Invoke-RestMethod -Uri 'https://api.github.com/repos/PowerShell/PowerShell/releases' `
+                  -Headers @{
+                    'Accept' = 'application/vnd.github+json'
+                    'Authorization' = "Bearer $($env:GITHUB_TOKEN)"
+                    'X-GitHub-Api-Version' = '2022-11-28'
+                  }
+                $latestPreview = $releases | Where-Object { $_.prerelease -eq $true } | Select-Object -First 1
+                $latest = $latestPreview.tag_name.TrimStart('v')
+                Write-Host "Latest preview PowerShell release detected: $latest"
+            } else {
+                $latest = (
+                  Invoke-RestMethod -Uri 'https://api.github.com/repos/PowerShell/PowerShell/releases/latest' `
+                  -Headers @{
+                    'Accept' = 'application/vnd.github+json'
+                    'Authorization' = "Bearer $($env:GITHUB_TOKEN)"
+                    'X-GitHub-Api-Version' = '2022-11-28'
+                  }
+                ).tag_name.TrimStart('v')
+                Write-Host "Latest stable PowerShell release detected: $latest"
+            }
             $env:REQUESTED_VERSION = $latest
         } elseif ([string]::IsNullOrWhiteSpace($req)) {
             Write-Host "Error: Version input is required (or use 'latest')"