Backup Pointing Devices List to JSON

<#
.SYNOPSIS
    Backs up Pointing Devices (Win32_PointingDevice) to a timestamped JSON file.

.DESCRIPTION
    Queries Win32_PointingDevice via WMI and writes Name, Manufacturer, NumberOfButtons 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-PointingDeviceListToJson.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_PointingDevice | Select-Object Name, Manufacturer, NumberOfButtons
$timestamp = Get-Date -Format 'yyyyMMdd-HHmmss'
$outPath = Join-Path $OutputFolder "pointingdevice-snapshot_$timestamp.json"

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

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