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 = @() ) # Внутренние пути модуля $privateDir = Join-Path $PSScriptRoot "Private" Initialize-MonsterLogging -ScriptName "monster_module" -VerboseLogging:$PSBoundParameters['Verbose'] Write-Log -Level "VERBOSE" -Message "Инициализация функции Invoke-MonsterMaintenance." -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 "Указано несколько взаимоисключающих флагов действий." -Context "MODULE" throw "Указано несколько взаимоисключающих флагов действий." } if ($actionCount -eq 0) { Write-Host "Использование: Invoke-MonsterMaintenance [-Start | -Optimize | -ResetUsb | -CheckWU | -InstallWU | -Auto | -Install | -Remove | -Check | -Fix]" -ForegroundColor Cyan return } # 1. Маршрутизация -Start (Пнуть задачу очистки под TrustedInstaller) if ($Start) { Write-Log -Level "INFO" -Message "Запуск задачи MonsterMaintenancePermanent..." -Context "MODULE" Start-ScheduledTask -TaskName "MonsterMaintenancePermanent" -ErrorAction Stop Write-Log -Level "SUCCESS" -Message "Задача заведена в планировщик под TrustedInstaller." -Context "MODULE" return } # 2. Маршрутизация -RepairApps if ($RepairApps) { Write-Log -Level "INFO" -Message "Запуск задачи MonsterRepairApps..." -Context "MODULE" Start-ScheduledTask -TaskName "MonsterRepairApps" -ErrorAction Stop Write-Log -Level "SUCCESS" -Message "Задача восстановления приложений запущена." -Context "MODULE" 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 } & $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 } & $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 } & $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 } & $wuScript @wuArgs return } } # Экспорт публичной функции наружу Export-ModuleMember -Function 'Invoke-MonsterMaintenance' |