private/core-license/Show-OSDCoreLicenseHelp.ps1

function Show-OSDCoreLicenseHelp {
    <#
    .SYNOPSIS
    Displays instructions for registering an OSDeploy PC.
 
    .DESCRIPTION
    Provides a concise, step-by-step guide to download, import, and verify the
    Recast Software Community License used by OSDeploy.
 
    .PARAMETER LicensePath
    The directory path where .license2 files should be stored when not using
    a full Right Click Tools Community Edition installation.
 
    .EXAMPLE
    Show-OSDCoreLicenseHelp
    Displays setup steps for ProgramData\Recast Software\Licenses.
 
    .EXAMPLE
    Show-OSDCoreLicenseHelp -LicensePath 'D:\Licenses'
    Displays setup steps and checks a custom license directory.
 
    .LINK
    https://www.osdeploy.com/guide/registration
 
    .LINK
    https://portal.recastsoftware.com/
 
    .NOTES
    Author: David Segura - Recast Software
    2026-07-22 - Initial help block created
    2026-07-22 - Added OSDCloud Recast Core license setup guidance
    2026-08-26 - Updated Community License installation and verification guidance
    2026-09-02 - Aligned guidance with Import-OSDeployLicense registration workflow
    #>

    [CmdletBinding()]
    param (
        [Parameter()]
        [string]$LicensePath = (Join-Path -Path $env:ProgramData -ChildPath 'Recast Software\Licenses')
    )

    Write-Host -ForegroundColor DarkYellow "No usable Recast Software Community License was found in $LicensePath"
    Write-Host ''
    Write-Host -ForegroundColor DarkCyan 'Recast Community License for OSDeploy'
    Write-Host -ForegroundColor DarkGray 'Follow these steps to download, import, and verify the license.'
    Write-Host ''

    Write-Host -ForegroundColor DarkYellow '1. Open the Recast Software Community Portal and create an account or sign in:'
    Write-Host ' https://portal.recastsoftware.com/'
    Write-Host ''

    Write-Host -ForegroundColor DarkYellow '2. Download the license ZIP for Right Click Tools Community Edition.'
    Write-Host ''

    Write-Host -ForegroundColor DarkYellow '3. Open PowerShell 7.6 or later as an administrator.'
    Write-Host -ForegroundColor DarkYellow ' Import the downloaded ZIP or an extracted .license2 file:'
    Write-Host ' $LicenseFile = ''C:\Path\To\CommunityLicense.zip'''
    Write-Host ' Import-OSDeployLicense -LicenseFile $LicenseFile'
    Write-Host ''
    Write-Host -ForegroundColor DarkYellow '4. Verify the installed license:'
    Write-Host ' Show-OSDeployLicense'
    Write-Host ''
    Write-Host -ForegroundColor DarkGray 'Detailed instructions:'
    Write-Host ' https://www.osdeploy.com/guide/registration'
    Write-Host ''
}