🛠️ PowerShell IT Support Toolkit

A professional Windows desktop application and PowerShell script collection for IT support, troubleshooting, system diagnostics, and automation.

---

📖 Overview

PowerShell IT Support Toolkit is a curated collection of PowerShell scripts designed to simplify common IT support and Windows administration tasks.

Now packaged as a professional Windows desktop application, the project focuses on real-world scenarios encountered by IT Support Engineers, Help Desk Technicians, and System Administrators, providing practical scripts for system diagnostics, troubleshooting, automation, reporting, networking, and Windows management.

Every script is written with readability, consistency, and maintainability in mind while following PowerShell best practices and Microsoft's approved naming conventions.

---

✨ Features

• Windows Administration: Manage services, processes, and active system states.
• System Health Reporting: Generate full PC inventory reports in structured JSON formats.
• Network Diagnostics: Ping, traceroute, port testing, and IP configuration.
• Event Log Analysis: Analyze and export Windows Event Viewer logs.
• Storage Management: Analyze disk space and safely clear temporary files.
• User Management: Query and manage local Windows user accounts.
• IT Support Automation: Automate repetitive tasks and scheduled cleanups.
• Professional Windows Integration: Delivered as a lightweight C# executable launcher and formal Windows installer.

---

⚠️ Security & Safety Note

Because this is an IT administration toolkit containing scripts capable of modifying Windows services, local users, networking interfaces, and storage files:

• Administrative scripts should be reviewed before execution.
• Certain operations (like restarting services or managing users) require elevated Administrator privileges.
• Destructive operations (like temporary file cleanup) should be used carefully.
• Scripts should be tested in a safe environment before being deployed in production.

---

💻 Requirements

Running the Packaged Application

• OS: Windows 10/11
• PowerShell: Windows PowerShell 5.1+

Building the Project from Source

• OS: Windows
• PowerShell: Windows PowerShell 5.1+
• Compiler: .NET Framework (C# Compiler csc.exe included natively in Windows)
• Installer Framework: Inno Setup 6 (required to generate the installer executable)

---

🚀 Installation

The project provides a professional Windows installer generated with Inno Setup.

1. Run PowerShell-IT-Support-Toolkit-Setup.exe.
2. Follow the standard installation wizard. The application installs to C:\Program Files\PowerShell IT Support Toolkit\.
3. The installer automatically packages the application executable, PowerShell scripts, documentation, and required branding assets.
4. Launch the application from your Start Menu or Desktop shortcut.

---

🛠️ Usage

Launching the application opens an interactive, menu-driven terminal interface designed for quick support operations.

Main Menu

1. System Information
2. Running Processes
3. Running Services
4. Disk Usage
5. Network Diagnostics
6. Event Logs
7. Cleanup Temp Files
8. Generate Full PC Report
9. Exit

Event Logs Submenu

The toolkit provides a dedicated event log inspector:

1. Get System Errors
2. Get Boot Events
3. Export Event Logs
4. Back to Main Menu

Note: When using Export Event Logs, provide valid Windows event log names such as System or Application.

---

📊 Reporting & Runtime Data

The toolkit generates and stores artifacts locally to ensure no required write access to C:\Program Files\.

The runtime data is strictly isolated to your user profile:

• Base Directory: %LOCALAPPDATA%\PowerShell-IT-Support-Toolkit\
• System Reports: %LOCALAPPDATA%\PowerShell-IT-Support-Toolkit\reports\
• Event Log Exports: %LOCALAPPDATA%\PowerShell-IT-Support-Toolkit\exports\

Note: Generated runtime reports and logs are local machine artifacts and are not committed to the repository. The toolkit never exposes real user machine information in its source.

---

📂 Project Structure

PowerShell-IT-Support-Toolkit/
├── assets/                  # Images and project branding (itsjoxdev-logo.txt)
├── docs/                    # Documentation for scripts and guides
├── examples/                # Example outputs and demonstrations
├── screenshots/             # Application screenshots
├── scripts/                 # PowerShell scripts organized by category
│   ├── automation/
│   ├── common/
│   ├── eventlogs/
│   ├── networking/
│   ├── reports/
│   ├── services/
│   ├── storage/
│   ├── system/
│   └── users/
├── src/                     # C# wrapper source code
│   ├── AssemblyInfo.cs
│   └── IT-Toolkit.cs
├── build.ps1                # Master build and staging automation script
├── installer.iss            # Inno Setup compiler configuration
├── .gitignore
├── LICENSE
└── README.md

Note: During the build process, build/ and release/ directories are generated to hold temporary staging artifacts and the final installer. These directories are intentionally ignored by Git.

---

🏗️ Build From Source

The repository includes a deterministic build pipeline that converts the scripts into a professional desktop application without rewriting the underlying PowerShell logic.

Build Pipeline:

1. PowerShell build script (build.ps1 controls the flow)
2. C# executable compilation (src/IT-Toolkit.cs and src/AssemblyInfo.cs)
3. Application staging (Files are staged into build\Application)
4. Staging validation (Verifies all dependencies are present)
5. Inno Setup compilation (installer.iss)
6. Installer generated (Output placed in release/)

The C# Launcher

src/IT-Toolkit.cs is compiled into a lightweight executable (IT-Toolkit.exe). It is not a full C# rewrite of the toolkit; rather, it serves as a secure launcher that natively invokes the primary scripts\IT-Toolkit.ps1 script using a process-scoped execution policy. This ensures the toolkit launches seamlessly without weakening your system-wide PowerShell execution policies.

---

📸 Screenshots / Demo

Main Menu

This is the main interactive menu providing access to the toolkit's major IT support functions.

System Information

The toolkit can collect hardware, operating system, network, storage, and uptime information.

Running Services

The toolkit can enumerate Windows services and summarize running/stopped services.

Disk Usage

The toolkit provides disk/storage information for troubleshooting and system maintenance.

Network Diagnostics

The networking tools provide connectivity and network troubleshooting capabilities.

Event Log Export

Event logs can be queried and exported to JSON for further analysis or troubleshooting.

Full PC Report

The toolkit can generate a consolidated PC/system report.

---

📚 Documentation

Detailed documentation is available in the docs/ directory:

• Best Practices
• Commands
• Installation Guide
• Troubleshooting

---

📦 Script Categories

🖥️ System

Scripts related to Windows system information, resource monitoring, and hardware diagnostics.

• Get-SystemInfo.ps1
• Get-Uptime.ps1
• Get-DiskInfo.ps1
• Get-MemoryUsage.ps1
• Get-CPUUsage.ps1
• Get-Processes.ps1

🌐 Networking

Scripts for network troubleshooting and diagnostics.

• Invoke-NetworkDiagnostics.ps1
• Get-IPConfiguration.ps1
• Test-Internet.ps1
• Test-Ping.ps1
• Test-Port.ps1
• TraceRoute.ps1
• Flush-DNS.ps1
• Renew-IP.ps1

⚙️ Services

Manage Windows Services.

• Get-AllServices.ps1
• Restart-ServiceSafely.ps1
• Start-Service.ps1
• Stop-Service.ps1

📋 Event Logs

Analyze Windows Event Viewer logs.

• Export-EventLogs.ps1
• Get-BootEvents.ps1
• Get-SystemErrors.ps1

💾 Storage

Storage management and cleanup.

• Clear-TempFiles.ps1
• Find-LargeFile.ps1
• Get-DiskSpaceReport.ps1

👤 Users

Local Windows user management.

• List-LocalUsers.ps1
• Enable-User.ps1
• Disable-User.ps1
• Password-Expiry.ps1

📊 Reports

Generate useful system reports.

• Get-SystemInventory.ps1
• New-PCReport.ps1

🤖 Automation

Automation scripts for repetitive IT tasks.

• Backup-FolderData.ps1
• New-LocalUser.ps1
• Scheduled-Cleanup.ps1

---

🚧 Project Status

Version: v1.0.0
Status: Initial stable release

---

📄 License

This project is proprietary and closed-source. All rights are reserved by the copyright holder.

Redistribution, modification, publication, and commercial use require explicit authorization. See the LICENSE file for complete details.

---

Made with ❤️ using PowerShell