Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SysAdmin Toolkit

A Windows PowerShell utility for checking system health, investigating common issues, and running selected maintenance and repair actions with user confirmation.

Collect → Analyze → Explain → Recommend → Confirm → Repair → Report


Features

The toolkit includes system health checks, performance and inventory information, Windows Event Log analysis, service and security checks, selected Windows and network repairs, cleanup and large-file scanning, and HTML or JSON reports.

Repair and cleanup actions require confirmation before they are executed. Read-only checks do not change the system.


Requirements

Requirement Supported value
Operating system Windows 10, Windows 11, or Windows Server 2016/2019/2022
PowerShell Windows PowerShell 5.1 or later
Permissions Standard user for read-only checks; Administrator for protected repairs

The toolkit should be tested on a non-production device before it is used on a managed or business-critical system.


User guide

لشرح فكرة المشروع، المميزات، الأقسام، طرق التشغيل، الصلاحيات، وسير العمل الآمن، راجع دليل الاستخدام العربي.


Installation and Usage Demo

This short video provides a quick walkthrough of the SysAdmin Toolkit. It shows how to launch the project, which files are involved, and how to start using the toolkit when troubleshooting a Windows issue.

This is only a short walkthrough. The project includes additional features and details that are not covered in the video.

SysAdmin_Demo.mp4

Choose a launch method

Option A: One-file launch

Run SysAdmin.cmd by double-clicking it. The file contains the PowerShell source, so no separate .ps1 file is required.

Option B: PowerShell source and launcher

Keep these files in the same folder:

SysAdmin.ps1
Run-SysAdmin.bat

Double-click Run-SysAdmin.bat, or run the source directly from PowerShell:

powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\SysAdmin.ps1

The toolkit creates Logs and Reports folders when needed. These folders contain local session data and should not be uploaded to GitHub.


License

This project is released under the MIT License. See LICENSE.

About

A PowerShell toolkit for Windows diagnostics, troubleshooting, maintenance, and guided repair actions.

Topics

Resources

Stars

8 stars

Watchers

3 watching

Forks

Releases

Contributors

Languages