56 lines
2.3 KiB
Markdown
56 lines
2.3 KiB
Markdown
# Windows deployment ensemble (PowerShell)
|
|
|
|
Документ фиксирует профессиональный workflow развёртывания и контроля ActivityWatch-клиентов в домене Windows.
|
|
|
|
## Полные пути
|
|
|
|
- `/home/igor/tmp/AWatch-rus/windows/deploy-ensemble.ps1`
|
|
- `/home/igor/tmp/AWatch-rus/windows/deploy-domain-users.ps1`
|
|
- `/home/igor/tmp/AWatch-rus/windows/deploy-single-user.ps1`
|
|
- `/home/igor/tmp/AWatch-rus/windows/hardening-recovery.ps1`
|
|
- `/home/igor/tmp/AWatch-rus/windows/validate-deployment.ps1`
|
|
- `/home/igor/tmp/AWatch-rus/windows/ActivityWatch.Windows.Common.psm1`
|
|
- `/home/igor/tmp/AWatch-rus/windows/ActivityWatch.Windows.Common.psd1`
|
|
|
|
## Рекомендованный запуск
|
|
|
|
```powershell
|
|
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process
|
|
|
|
C:\Program Files\AWatch-rus\windows\deploy-ensemble.ps1 `
|
|
-ServerHost 10.10.10.13 `
|
|
-ServerPort 5600 `
|
|
-Domain SHARKON2025 `
|
|
-Users user1,user2,user3,user4,user5 `
|
|
-InstallRoot 'C:\Program Files\AWatch-rus\bin' `
|
|
-StateRoot 'C:\ProgramData\AWatch-rus' `
|
|
-AfkEnabled:$false `
|
|
-CustomPolicyPath C:\Program Files\AWatch-rus\windows\dlp-policy.example.json `
|
|
-ValidateAfterDeploy
|
|
```
|
|
|
|
## Что делает `deploy-ensemble.ps1`
|
|
|
|
1. Нормализует список пользователей (`DOMAIN\user`).
|
|
2. Вызывает массовый деплой `deploy-domain-users.ps1`.
|
|
3. Применяет hardening/recovery (`hardening-recovery.ps1`), если не задан `-SkipHardening`.
|
|
4. Опционально запускает контроль (`validate-deployment.ps1`) при `-ValidateAfterDeploy`.
|
|
5. Пишет итоговый JSON-отчёт в `<StateRoot>\ensemble-report-*.json`.
|
|
|
|
Для quiet-профиля без `afkstatus` используйте `-AfkEnabled:$false`; если не нужен window watcher, добавьте `-WindowEnabled:$false`.
|
|
|
|
## Быстрый health-check
|
|
|
|
```powershell
|
|
$report = C:\Program Files\AWatch-rus\windows\validate-deployment.ps1 `
|
|
-ConfigPath C:\ProgramData\AWatch-rus\deployment-config.json
|
|
$report | ConvertTo-Json -Depth 12
|
|
```
|
|
|
|
Ожидается:
|
|
|
|
- `overallOk = true`
|
|
- нет missing-файлов
|
|
- все `ActivityWatch*` Scheduled Task присутствуют
|
|
- активны процессы `aw-watcher-afk` и `aw-watcher-window`
|