Backup Keyboard Info List to JSON

<#
.SYNOPSIS
    Backs up Keyboard Info (Win32_Keyboard) to a timestamped JSON file.

.DESCRIPTION
    Queries Win32_Keyboard via WMI and writes Description, Layout, NumberOfFunctionKeys for every item to a
    JSON file, useful as a point-in-time snapshot for change tracking.

.PARAMETER OutputFolder
    Folder to write the JSON snapshot into. Created if it doesn't exist.
    Defaults to the current directory.

.EXAMPLE
    .\Backup-KeyboardListToJson.ps1 -OutputFolder C:\Snapshots
#>

[CmdletBinding()]
param(
    [string]$OutputFolder = '.'
)

if (-not (Test-Path $OutputFolder)) {
    New-Item -ItemType Directory -Path $OutputFolder -Force | Out-Null
}

$items = Get-CimInstance -ClassName Win32_Keyboard | Select-Object Description, Layout, NumberOfFunctionKeys
$timestamp = Get-Date -Format 'yyyyMMdd-HHmmss'
$outPath = Join-Path $OutputFolder "keyboard-snapshot_$timestamp.json"

$items | ConvertTo-Json -Depth 3 | Out-File -FilePath $outPath -Encoding UTF8

Write-Host "Snapshot of Keyboard Info ($($items.Count) items) saved to $outPath" -ForegroundColor Green