MonsterScript.psm1
|
# ============================================================================== # MONSTER SCRIPT ENTERPRISE - ROOT MODULE FILE # Файл: MonsterScript.psm1 # Назначение: Главный файл модуля, содержащий публичную функцию-оркестратор и локализацию # ============================================================================== # Автоматический импорт ядра при загрузке модуля $coreModulePath = Join-Path $PSScriptRoot "Private\MonsterCore.psm1" if (Test-Path $coreModulePath) { Import-Module $coreModulePath -Force } else { throw "[CRITICAL] Не найден модуль ядра: $coreModulePath" } function Invoke-MonsterMaintenance { [CmdletBinding()] param( [switch]$Install, [switch]$Remove, [switch]$Check, [switch]$Fix, [switch]$Auto, # Фоновый автозапуск (с проверками DND / Active Hours) [switch]$Start, # Ручной вызов: пнуть задачу очистки под TrustedInstaller [switch]$RepairApps, # Ручной вызов восстановления UWP/AppX под TrustedInstaller [switch]$ExecuteCleanup,# Служебный флаг выполнения очистки [switch]$Optimize, # Запуск модуля системной оптимизации [switch]$ResetUsb, # Экстренный сброс USB Host-контроллеров [switch]$CheckWU, # Проверка доступных обновлений Windows [switch]$InstallWU, # Установка обновлений Windows [string]$Path, [string]$Script, [string[]]$Only = @(), [string[]]$Skip = @(), [Parameter(Mandatory = $false)] [ValidatePattern("^[a-zA-Z]{2}(-[a-zA-Z]{2,4})?$")] [string]$Language ) # 1. Установка языка и загрузка локализации через ядро if ($Language) { Set-MonsterLanguage -Language $Language } $msg = Get-MonsterLocalization -ComponentName "MonsterScript" -Language $Language $txtStart = if ($msg.ModuleStart) { $msg.ModuleStart } else { "Инициализация функции Invoke-MonsterMaintenance." } $txtMultiAction = if ($msg.MultiActionError) { $msg.MultiActionError } else { "Указано несколько взаимоисключающих флагов действий." } $txtTaskStart = if ($msg.TaskStart) { $msg.TaskStart } else { "Запуск задачи MonsterMaintenancePermanent..." } $txtTaskSuccess = if ($msg.TaskSuccess) { $msg.TaskSuccess } else { "Задача заведена в планировщик под TrustedInstaller." } $txtAppsStart = if ($msg.AppsStart) { $msg.AppsStart } else { "Запуск задачи MonsterRepairApps..." } $txtAppsSuccess = if ($msg.AppsSuccess) { $msg.AppsSuccess } else { "Задача восстановления приложений запущена." } # Внутренние пути модуля $privateDir = Join-Path $PSScriptRoot "Private" Initialize-MonsterLogging -ScriptName "monster_module" -VerboseLogging:$PSBoundParameters['Verbose'] Write-Log -Level "VERBOSE" -Message $txtStart -Context "MODULE" # Определение целевого действия (Action Routing) $actionCount = 0 if ($Install) { $actionCount++ } if ($Remove) { $actionCount++ } if ($Check) { $actionCount++ } if ($Fix) { $actionCount++ } if ($Auto) { $actionCount++ } if ($Start) { $actionCount++ } if ($RepairApps) { $actionCount++ } if ($ExecuteCleanup){ $actionCount++ } if ($Optimize) { $actionCount++ } if ($ResetUsb) { $actionCount++ } if ($CheckWU) { $actionCount++ } if ($InstallWU) { $actionCount++ } if ($actionCount -gt 1) { Write-Log -Level "CRITICAL" -Message $txtMultiAction -Context "MODULE" throw $txtMultiAction } if ($actionCount -eq 0) { Write-Host "Использование: Invoke-MonsterMaintenance [-Start | -Optimize | -ResetUsb | -CheckWU | -InstallWU | -Auto | -Install | -Remove | -Check | -Fix] [-Language ru|ua|en]" -ForegroundColor Cyan return } # 1. Маршрутизация -Start (Пнуть задачу очистки под TrustedInstaller) if ($Start) { Write-Log -Level "INFO" -Message $txtTaskStart -Context "MODULE" try { & schtasks.exe /run /tn "MonsterMaintenancePermanent" 2>&1 | Out-Null if ($LASTEXITCODE -eq 0) { Write-Log -Level "SUCCESS" -Message $txtTaskSuccess -Context "MODULE" } else { throw "schtasks завершился с кодом ошибки: $LASTEXITCODE" } } catch { Write-Log -Level "ERROR" -Message "Не удалось запустить задачу MonsterMaintenancePermanent: $_" -Context "MODULE" throw } return } # 2. Маршрутизация -RepairApps if ($RepairApps) { Write-Log -Level "INFO" -Message $txtAppsStart -Context "MODULE" try { & schtasks.exe /run /tn "MonsterRepairApps" 2>&1 | Out-Null if ($LASTEXITCODE -eq 0) { Write-Log -Level "SUCCESS" -Message $txtAppsSuccess -Context "MODULE" } else { throw "schtasks завершился с кодом ошибки: $LASTEXITCODE" } } catch { Write-Log -Level "ERROR" -Message "Не удалось запустить задачу MonsterRepairApps: $_" -Context "MODULE" throw } return } # 3. Маршрутизация в task_manager if ($Install -or $Remove -or $Check -or $Fix) { $taskManagerScript = Join-Path $privateDir "task_manager.ps1" $managerArgs = @{} if ($Install) { $managerArgs['Install'] = $true } if ($Remove) { $managerArgs['Remove'] = $true } if ($Check) { $managerArgs['Check'] = $true } if ($Fix) { $managerArgs['Fix'] = $true } if ($PSBoundParameters['Verbose']) { $managerArgs['Verbose'] = $true } if ($Language) { $managerArgs['Language'] = $Language } & $taskManagerScript @managerArgs return } # 4. Маршрутизация очистки (-Auto / -ExecuteCleanup) if ($Auto -or $ExecuteCleanup) { $cleanerScript = Join-Path $privateDir "monster_cleanup.ps1" $safetyPassed = Assert-MonsterExecutionSafety -IsAutoStart:[bool]$Auto if (-not $safetyPassed) { return } $cleanerArgs = @{} if ($PSBoundParameters['Verbose']) { $cleanerArgs['Verbose'] = $true } if ($Only.Count -gt 0) { $cleanerArgs['Only'] = $Only } if ($Skip.Count -gt 0) { $cleanerArgs['Skip'] = $Skip } if ($Language) { $cleanerArgs['Language'] = $Language } & $cleanerScript @cleanerArgs return } # 5. Маршрутизация оптимизации (-Optimize) if ($Optimize) { $optimizerScript = Join-Path $privateDir "monster_optimizer.ps1" if (-not (Assert-MonsterExecutionSafety -IsAutoStart:$false)) { return } $optArgs = @{} if ($PSBoundParameters['Verbose']) { $optArgs['Verbose'] = $true } if ($Only.Count -gt 0) { $optArgs['Only'] = $Only } if ($Skip.Count -gt 0) { $optArgs['Skip'] = $Skip } if ($Language) { $optArgs['Language'] = $Language } & $optimizerScript @optArgs return } # 6. Маршрутизация сброса USB (-ResetUsb) if ($ResetUsb) { $usbScript = Join-Path $privateDir "monster_usb.ps1" if (-not (Assert-MonsterExecutionSafety -IsAutoStart:$false)) { return } & $usbScript return } # 7. Маршрутизация Windows Update (-CheckWU / -InstallWU) if ($CheckWU -or $InstallWU) { $wuScript = Join-Path $privateDir "monster_wu.ps1" if (-not (Assert-MonsterExecutionSafety -IsAutoStart:$false)) { return } $wuArgs = @{} if ($CheckWU) { $wuArgs['Check'] = $true } if ($InstallWU) { $wuArgs['Install'] = $true } if ($PSBoundParameters['Verbose']) { $wuArgs['Verbose'] = $true } if ($Language) { $wuArgs['Language'] = $Language } & $wuScript @wuArgs return } } # Экспорт публичной функции наружу Export-ModuleMember -Function 'Invoke-MonsterMaintenance' |