🛠️ SysMaint
[Sistem Pemeliharaan Windows]

SysMaint (Sistem Pemeliharaan Windows) adalah framework skrip berbasis PowerShell yang dirancang untuk mengotomatisasi seluruh siklus pemeliharaan rutin pada sistem operasi Windows (Workstation & Server). Skrip ini membantu Administrator Sistem, Engineer DevOps, dan Pengguna Daya (Power Users) dalam menjaga performa sistem tetap optimal, menghemat ruang penyimpanan, serta meminimalisasi potensi downtime akibat akumulasi file sampah atau log membesar.

---

📌 Daftar Isi

• Latar Belakang & Keunggulan
• Fitur Utama
• Prasyarat Sistem
• Panduan Instalasi & Persiapan
• Panduan Penggunaan
  • 1. Mode Interaktif (Tampilan Menu)
  • 2. Mode Otomatis / Non-Interaktif
  • 3. Eksekusi File Biner (.exe)
• Automasi dengan Task Scheduler
• Alur Kerja Skrip (Workflow)
• Troubleshooting & Pemecahan Masalah
• Panduan Kontribusi
• Lisensi & Kontak

---

🌟 Latar Belakang & Keunggulan

Seiring berjalannya waktu, sistem operasi Windows menumpuk file sementara (temporary files), cache pembaruan sistem (Windows Update), file prefetch, dan log event yang dapat memperlambat kinerja disk serta menghabiskan kapasitas penyimpanan. Latihan pemeliharaan manual memerlukan waktu dan berisiko terjadi kelalaian.

Mengapa Memilih SysMaint?

• Zero Dependencies: Berjalan langsung menggunakan modul bawaan Windows tanpa perlu menginstal third-party software atau modul external (npm, pip, NuGet).
• Safe & Non-Destructive: Hanya menghapus file yang aman untuk dibersihkan tanpa mengganggu integritas file sistem utama.
• Smart Storage Awareness: Dapat membedakan jenis media penyimpanan (SSD vs. HDD) secara otomatis untuk menerapkan teknik optimasi yang tepat (TRIM vs. Defrag).
• Enterprise Ready: Siap diintegrasikan dengan Windows Task Scheduler, Group Policy Object (GPO), Microsoft Intune, atau Active Directory Logon/Logoff scripts.

---

🚀 Fitur Utama

1. Pembersihan File Sampah & System Cleanup

• Menghapus seluruh direktori Temporary Files (C:\Windows\Temp dan %TEMP%).
• Mengosongkan Recycle Bin seluruh drive atau user profile.
• Membersihkan Windows Update Download Cache (C:\Windows\SoftwareDistribution\Download).
• Membersihkan direktori Prefetch dan Windows Error Reporting (WER) logs.
• Pembersihan Komponen Windows Image menggunakan DISM (/Cleanup-Image /StartComponentCleanup).

2. Optimasi & Kesehatan Media Penyimpanan (Disk Optimization)

• Deteksi otomatis jenis drive (Solid State Drive / Hard Disk Drive).
• Eksekusi perintah TRIM / Retrim pada drive SSD untuk menjaga daya tahan dan kecepatan write.
• Eksekusi Defragmentasi Terfragmentasi Terarah pada HDD konvensional.
• Pemeriksaan integritas kesehatan disk dasar via PowerShell Storage API.

3. Backup & Rotasi Log Sistem

• Mengekspor Windows Event Logs penting (System, Application, Security) ke berkas archive .evtx atau .zip.
• Melakukan rotasi dan pengarsipan log pemeliharaan otomatis berdasarkan batas usia hari (misal: hapus log > 30 hari).
• Menyimpan rekapikasi health report setelah skrip selesai dijalankan.

4. Monitoring Ruang Disk (Disk Space Alerting)

• Memberikan laporan statistik kapasitas sebelum dan sesudah proses pemeliharaan.
• Memberikan warning visual jika sisa kapasitas drive utama (C:) berada di bawah ambang batas aman (misal: < 15%).

---

📋 Prasyarat Sistem

Skrip ini bersifat fully self-contained dan siap dijalankan secara native pada lingkungan Windows berikut:

Komponen	Persyaratan Minimum	Rekomendasi	Status Modul
Sistem Operasi	Windows 10 / Windows Server 2016	Windows 11 / Windows Server 2022	Built-in Native
PowerShell	Versi 5.1	PowerShell 7.x (Core)	Terinstall bawaan
Hak Akses	Administrator (Elevated Prompt)	Administrator / Local System	Wajib
Modul Internal	Storage, Dism, Microsoft.PowerShell.Archive	Modul versi terbaru	Bawaan OS
Ruang Disk	Min. 100 MB ruang tersisa	> 1 GB untuk pemrosesan file temporary	Direkomendasikan

Catatan: Skrip ini tidak memerlukan library eksternal dari repositori publik saat dijalankan.

---

⚙️ Panduan Instalasi & Persiapan

Langkah 1: Pengunduhan Skrip

Kloning repositori ini menggunakan Git atau unduh berkas zip secara langsung:

git clone https://github.com/narendra-akmal/SysMaint.git
cd SysMaint

Langkah 2: Konfigurasi PowerShell Execution Policy

Secara default, Windows memblokir eksekusi skrip PowerShell yang belum terverifikasi. Izinkan eksekusi skrip untuk skop pengguna saat ini:

# Jalankan PowerShell sebagai Administrator
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

Langkah 3: Verifikasi Hak Akses Administrator

Pastikan Anda membuka PowerShell menggunakan opsi "Run as Administrator". Jika dijalankan tanpa hak akses Administrator, beberapa fungsi seperti pembersihan Windows\Temp dan perintah DISM akan dilewati demi keamanan.

---

💻 Panduan Penggunaan

1. Mode Interaktif (Tampilan Menu)

Mode ini sangat cocok untuk penggunaan harian oleh administrator secara manual melalui konsol.

# Jalankan skrip PowerShell
.\SysMaint.ps1

Skrip akan menampilkan GUI berbasis teks (CLI Menu) di mana Anda dapat memilih tugas pemeliharaan spesifik yang ingin dijalankan.

---

2. Mode Otomatis / Non-Interaktif (Unattended)

Mode ini digunakan untuk otomatisasi skrip tanpa memerlukan interaksi input dari pengguna.

# Menjalankan pemeliharaan penuh secara otomatis
.\SysMaint.ps1 -Auto -FullMaintenance -Verbose
# Menjalankan hanya fungsi pembersihan file temporary
.\SysMaint.ps1 -CleanOnly
# Menjalankan pembersihan dan optimasi disk tanpa backup log
.\SysMaint.ps1 -SkipLogBackup

---

3. Eksekusi File Biner (.exe)

Bagi pengguna yang membutuhkan versi portabel tanpa perlu membuka konsol PowerShell, Anda dapat mengunduh versi kompilasi .exe:

📥 [Download SysMaint.exe]

Cara Menggunakan .exe: Klik kanan pada berkas SysMaint.exe ➡️ Pilih "Run as Administrator".

---

📅 Automasi dengan Task Scheduler

Untuk menjaga performa server atau komputer desktop secara berkala, disarankan untuk mengonfigurasi skrip ini pada Windows Task Scheduler.

Menggunakan PowerShell Command:

Anda dapat merregistrasikan tugas terjadwal (misal: Setiap hari Minggu jam 02:00 pagi) menggunakan perintah berikut:

$Action = New-ScheduledTaskAction -Execute "PowerShell.exe" -Argument "-NoProfile -ExecutionPolicy Bypass -File 'C:\Path\To\SysMaint.ps1' -Auto -FullMaintenance"
$Trigger = New-ScheduledTaskTrigger -Weekly -DaysOfWeek Sunday -At 2am
$Principal = New-ScheduledTaskPrincipal -UserId "NT AUTHORITY\SYSTEM" -LogonType ServiceAccount -RunLevel Highest
Register-ScheduledTask -TaskName "SysMaint_Weekly_Maintenance" -Action $Action -Trigger $Trigger -Principal $Principal

---

🔄 Alur Kerja Skrip (Workflow)

[ Start Eksekusi ]
       │
       ▼
[ Validasi Admin Rights ] ──(Gagal)──► [ Tampilkan Warning & Terminate ]
       │ (Sukses)
       ▼
[ Cek Ruang Disk Awal ]
       │
       ▼
[ Backup & Kompresi Log ] ──► [ Simpan ke Archive Folder ]
       │
       ▼
[ Pembersihan File Temp ] ──► [ System Temp, Prefetch, Recycle Bin, DISM Cache ]
       │
       ▼
[ Deteksi Tipe Drive ]
       ├── (Jika SSD) ───────► [ Jalankan TRIM / Optimize-Volume ]
       └── (Jika HDD) ───────► [ Jalankan Defragmentasi ]
       │
       ▼
[ Cek Ruang Disk Akhir ] ──► [ Hitung Total Kapasitas Dirilis ]
       │
       ▼
[ Buat Log Pemeliharaan ]
       │
       ▼
[ Selesai / Exit ]

---

❓ Troubleshooting & Pemecahan Masalah

Masalah / Error Message	Kemungkinan Penyebab	Solusi Pemecahan
❌ Access Denied / Permission Error	Skrip dijalankan tanpa hak akses elevasi (Elevated Privileges).	Klik kanan pada PowerShell / SysMaint.exe lalu pilih Run as Administrator.
❌ File cannot be loaded because running scripts is disabled	Kebijakan Execution Policy Windows masih dalam kondisi pembatasan Restricted.	Jalankan perintah Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.
❌ Defragmentation / TRIM Failed	Perintah optimasi dijalankan pada Virtual Disk, Storage Spaces, atau butuh akses akun SYSTEM.	Akses defrag pada Mesin Virtual (VM) ditangani oleh Hypervisor. Untuk OS Fisik, pastikan dipanggil via Task Scheduler akun SYSTEM.
❌ Locked Files / File in Use	File temporary sedang digunakan oleh program yang sedang berjalan aktif.	Skrip secara otomatis akan melompati (skip) file yang terkunci tanpa menghentikan seluruh proses.

---

🤝 Panduan Kontribusi

Kami sangat menyambut kontribusi dari komunitas untuk meningkatkan fungsionalitas SysMaint!

1. Fork repositori ini.
2. Buat feature branch baru:

   git checkout -b feature/FiturBaruKeren
   

3. Lakukan commit pada perubahan Anda (gunakan format commit yang jelas):

   git commit -m "feat: Menambahkan modul pembersihan log IIS"
   

4. Push branch Anda ke remote repository:

   git push origin feature/FiturBaruKeren
   

5. Buka Pull Request (PR) baru pada cabang main repositori ini.

---

📄 Lisensi

Proyek ini didistribusikan di bawah lisensi MIT License. Anda bebas menggunakan, memodifikasi, mendistribusikan, dan memanfaatkannya secara komersial maupun pribadi tanpa batasan. Lihat berkas LICENSE untuk informasi lebih lanjut.

---

📞 Kontak & Pengembang

• Developer: Narendra Akmal
• GitHub Repositori: github.com/narendra-akmal/SysMaint
• Pelaporan Bug & Masalah: GitHub Issues

─────────────────────────────────────────────────────────────────────────────
SysMaint Framework | Built with PowerShell
Tested on: Windows 10, Windows 11, Windows Server 2016/2019/2022
Last Documentation Update: August 2026
─────────────────────────────────────────────────────────────────────────────