Skip to content

RedjiJB/window-admin-toolkit

Repository files navigation

Windows Admin Toolkit (WAT) - Enterprise Edition v2.0

A professional-grade, enterprise-ready PowerShell toolkit for comprehensive Windows administration, automation, and security management.

Project Overview

The Windows Admin Toolkit (WAT) Enterprise Edition provides modular, secure, and well-documented PowerShell functions for complete Windows administration including user management, backup automation, security operations, network management, and system health monitoring.

Version: 2.0.0 - Enterprise Edition Author: Redji Jean Baptiste

Features

Core Modules

1. User Management Module

  • Create, modify, and delete local and Active Directory users
  • Bulk user operations from CSV
  • Password management with complexity validation
  • Account status management (enable/disable/lock)
  • Detailed audit logging

2. Backup Automation Module

  • Scheduled backup creation and management
  • Compression and integrity verification
  • Restore procedures with validation
  • Incremental and differential backup support
  • Email notifications for backup status
  • Automated retention management

3. Encryption Tools Module

  • File and folder encryption/decryption (EFS)
  • BitLocker drive encryption automation
  • Certificate management and deployment
  • Secure credential storage (DPAPI)
  • Key backup and recovery procedures

4. Network Operations Module

  • Port connectivity testing and troubleshooting
  • Network stack repair automation
  • WiFi profile management and password recovery
  • Static IP and DHCP configuration
  • Comprehensive network diagnostics with HTML reports

5. Credential Manager

  • Secure credential storage using DPAPI encryption
  • Credential retrieval for automation
  • Credential validation and testing
  • Enterprise credential management

6. HTML Reporter

  • Professional HTML report generation
  • Interactive dashboards with status indicators
  • Visual charts and progress bars
  • Customizable styling and branding
  • Export capabilities for all modules

Enterprise Framework

  • Interactive Menu System: Professional CLI interface with nested menus
  • Configuration Management: JSON-based config for environment portability
  • Comprehensive Logging: Centralized logging with severity levels
  • Error Handling: Robust try-catch blocks throughout
  • Security Best Practices: Input validation, secure credential handling
  • HTML Reporting: Professional reports with CSS styling
  • Modular Architecture: Independent modules for flexibility

Quick Start

Installation

# Clone the repository
git clone https://github.com/RedjiJB/WindowsAdminToolkit.git
cd WindowsAdminToolkit

# Import the toolkit
Import-Module .\WindowsAdminToolkit.psm1

# View available commands
Get-Command -Module WindowsAdminToolkit

Interactive Menu System (Recommended)

Launch the interactive menu for easy access to all functions:

# Run as Administrator
.\Start-Toolkit.ps1

This provides a professional CLI interface with:

  • Nested menus for each module
  • Input validation and error handling
  • Help and documentation access
  • Credential management
  • Report generation

Command-Line Usage

# User Management
New-WATUser -Username "jdoe" -FullName "John Doe" -Description "IT Staff"

# Backup Operations
New-WATBackup -SourcePath "C:\Data" -DestinationPath "D:\Backups" -Compress

# Encryption
Protect-WATFolder -Path "C:\Sensitive" -Method EFS

# Network Operations
Test-WATPortReachability -ComputerName "server01" -Port 80,443,3389

# Network Diagnostics with Report
Test-WATNetworkDiagnostics -GenerateReport

Project Structure

WindowsAdminToolkit/
├── Start-Toolkit.ps1                 # Interactive menu controller
├── WindowsAdminToolkit.psm1          # Main module file
├── WindowsAdminToolkit.psd1          # Module manifest
├── README.md                          # This file
├── LICENSE                            # MIT License
├── LAB_GUIDE.md                      # Comprehensive lab exercises
├── PROJECT_SUBMISSION.md             # Submission documentation
│
├── Core/                              # Enterprise framework
│   ├── CredentialManager.psm1        # Secure credential storage
│   └── HTMLReporter.psm1             # Professional report generation
│
├── Modules/                           # Functional modules
│   ├── UserManagement/
│   │   ├── UserManagement.psm1
│   │   └── UserManagement.Tests.ps1
│   ├── BackupAutomation/
│   │   ├── BackupAutomation.psm1
│   │   └── BackupAutomation.Tests.ps1
│   ├── EncryptionTools/
│   │   ├── EncryptionTools.psm1
│   │   └── EncryptionTools.Tests.ps1
│   ├── NetworkOps/
│   │   ├── NetworkOps.psm1
│   │   └── NetworkOps.Tests.ps1
│   ├── PatchManagement/              # Future expansion
│   ├── LogForensics/                 # Future expansion
│   ├── RemoteManagement/             # Future expansion
│   └── AssetInventory/               # Future expansion
│
├── Config/
│   ├── config.json                   # Module configuration
│   └── logging.json                  # Logging configuration
│
├── Docs/
│   ├── UserManagement.md
│   ├── BackupAutomation.md
│   ├── EncryptionTools.md
│   ├── NetworkOps.md                 # Network operations guide
│   ├── CredentialManager.md          # Credential management guide
│   └── Examples.md                   # 20+ usage examples
│
├── Reports/                          # HTML reports (auto-generated)
├── Logs/                             # Execution logs (auto-generated)
└── Tests/                            # Pester tests
    └── Toolkit.Tests.ps1

Security Considerations

  • All operations are logged with timestamps and user context
  • Credential management uses SecureString and CredentialManager
  • Input validation and sanitization on all parameters
  • Requires appropriate privileges (Run as Administrator)
  • Supports audit trails for compliance

Documentation

Detailed documentation for each module is available in the Docs/ folder:

Testing

# Run all tests
Invoke-Pester -Path .\Tests\

# Run specific module tests
Invoke-Pester -Path .\Modules\UserManagement\UserManagement.Tests.ps1

Requirements

  • Windows 10/11 or Windows Server 2016+
  • PowerShell 5.1 or PowerShell 7+
  • Administrator privileges for most operations
  • Active Directory module (for AD operations)
  • BitLocker feature enabled (for BitLocker operations)

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Submit a pull request

License

MIT License - See LICENSE file for details

Author

Redji Jean Baptiste Software Developer & IT Professional

Acknowledgments

  • PowerShell Community
  • Microsoft PowerShell Documentation

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors