Private/monster_usb.ps1

# ==============================================================================
# MONSTER SCRIPT ENTERPRISE - USB RESET PAYLOAD (MODULE EDITION)
# Файл: Private\monster_usb.ps1
# Назначение: Экстренный сброс и перезапуск USB Host-контроллеров (xHCI)
# ==============================================================================

[CmdletBinding()]
param()

$isVerbose = $PSBoundParameters['Verbose'] -or ($VerbosePreference -eq 'Continue')

Write-Log -Level "INFO" `
    -Message "Инициализация подсистемы экстренного сброса USB-контроллеров..." `
    -Context "USB"

# ------------------------------------------------------------------------------
# 1. ПРОВЕРКА ПРАВ АДМИНИСТРАТОРА
# ------------------------------------------------------------------------------

$isAdmin = (
    [Security.Principal.WindowsPrincipal](
        [Security.Principal.WindowsIdentity]::GetCurrent()
    )
).IsInRole(
    [Security.Principal.WindowsBuiltInRole]::Administrator
)

if (-not $isAdmin) {
    Write-Log -Level "CRITICAL" `
        -Message "Сброс USB-контроллеров требует запуска от имени Администратора!" `
        -Context "USB"

    Write-Error "Операция требует прав Администратора."
    exit 1
}

try {
    Write-Log -Level "INFO" `
        -Message "Поиск USB Host-контроллеров (xHCI) в системе..." `
        -Context "USB"

    # Находим все хост-контроллеры USB 3.0 / xHCI
    $usbControllers = Get-PnpDevice -Class "USB" -Status "OK" |
        Where-Object {
            $_.FriendlyName -like "*xHCI*" -or
            $_.FriendlyName -like "*USB Host Controller*"
        }

    if ($null -eq $usbControllers -or $usbControllers.Count -eq 0) {
        # Запасной вариант поиска по классу USB
        $usbControllers = Get-PnpDevice |
            Where-Object {
                $_.Class -eq "USB" -and (
                    $_.Name -like "*Host Controller*" -or
                    $_.HardwareId -like "*USB*CONTROLLER*"
                )
            }
    }

    if ($null -eq $usbControllers -or $usbControllers.Count -eq 0) {
        Write-Log -Level "WARNING" `
            -Message "Не удалось автоматически обнаружить USB Host-контроллеры для сброса." `
            -Context "USB"

        Write-Host "[!] Подходящие USB-контроллеры не найдены." `
            -ForegroundColor Yellow

        exit 0
    }

    foreach ($controller in $usbControllers) {
        $devId = $controller.InstanceId
        $devName = $controller.FriendlyName

        Write-Log -Level "INFO" `
            -Message "Перезапуск контроллера: $devName ($devId)..." `
            -Context "USB"

        Write-Host "[*] Сброс контроллера: $devName" `
            -ForegroundColor Cyan

        try {
            # Отключение устройства
            Disable-PnpDevice `
                -InstanceId $devId `
                -Confirm:$false `
                -ErrorAction Stop

            Start-Sleep -Seconds 3

            # Включение устройства обратно
            Enable-PnpDevice `
                -InstanceId $devId `
                -Confirm:$false `
                -ErrorAction Stop

            Start-Sleep -Seconds 3

            Write-Log -Level "SUCCESS" `
                -Message "Контроллер успешно перезапущен: $devName" `
                -Context "USB"
        }
        catch {
            Write-Log -Level "ERROR" `
                -Message "Не удалось перезапустить контроллер $($devName): $_" `
                -Context "USB"
        }
    }

    Write-Log -Level "SUCCESS" `
        -Message "Процедура экстренного сброса USB-контроллеров успешно завершена." `
        -Context "USB"

    Write-Host "[OK] Сброс USB-контроллеров выполнен." `
        -ForegroundColor Green

    exit 0
}
catch {
    Write-Log -Level "CRITICAL" `
        -Message "Критическая ошибка при сбросе USB-контроллеров: $_" `
        -Context "USB"

    exit 1
}