Backup USB Controllers List to JSON

<#
.SYNOPSIS
    Backs up USB Controllers (Win32_USBController) to a timestamped JSON file.

.DESCRIPTION
    Queries Win32_USBController via WMI and writes Name, Manufacturer, Status 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-USBControllerListToJson.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_USBController | Select-Object Name, Manufacturer, Status
$timestamp = Get-Date -Format 'yyyyMMdd-HHmmss'
$outPath = Join-Path $OutputFolder "usbcontroller-snapshot_$timestamp.json"

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

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