INSTALLATION.txt
|
# WiFiAnalyzer Module - Complete Fix and Installation ## Issues Fixed 1. **Duplicate -Debug Parameter**: Removed explicit -Debug parameter that conflicted with [CmdletBinding()] 2. **Emoji Encoding**: All emojis removed to prevent encoding issues 3. **Alias Export**: Show-WiFiAnalyzerGUI properly exported as an alias ## Installation Instructions ### Option 1: Install to System (All Users) - RECOMMENDED Run PowerShell as Administrator: ```powershell # 1. Remove any existing versions Remove-Item "C:\Program Files\WindowsPowerShell\Modules\WiFiAnalyzer" -Recurse -Force -ErrorAction SilentlyContinue Remove-Item "$HOME\Documents\WindowsPowerShell\Modules\WiFiAnalyzer" -Recurse -Force -ErrorAction SilentlyContinue # 2. Create module directory $modulePath = "C:\Program Files\WindowsPowerShell\Modules\WiFiAnalyzer\1.0.7" New-Item -ItemType Directory -Path $modulePath -Force # 3. Copy the fixed files (adjust paths to where you downloaded them) Copy-Item "C:\Users\jayala\Downloads\WiFiAnalyzer.psd1" $modulePath -Force Copy-Item "C:\Users\jayala\Downloads\WiFiAnalyzer.psm1" $modulePath -Force # 4. Import and test Import-Module WiFiAnalyzer -Force Get-Command -Module WiFiAnalyzer # 5. Run it! Start-WiFiAnalyzer # OR Show-WiFiAnalyzerGUI ``` ### Option 2: Install to Current User Only Run PowerShell (no admin needed): ```powershell # 1. Remove any existing versions Remove-Item "$HOME\Documents\WindowsPowerShell\Modules\WiFiAnalyzer" -Recurse -Force -ErrorAction SilentlyContinue # 2. Create module directory $modulePath = "$HOME\Documents\WindowsPowerShell\Modules\WiFiAnalyzer\1.0.7" New-Item -ItemType Directory -Path $modulePath -Force # 3. Copy the fixed files (adjust paths to where you downloaded them) Copy-Item "C:\Users\jayala\Downloads\WiFiAnalyzer.psd1" $modulePath -Force Copy-Item "C:\Users\jayala\Downloads\WiFiAnalyzer.psm1" $modulePath -Force # 4. Import and test Import-Module WiFiAnalyzer -Force Get-Command -Module WiFiAnalyzer # 5. Run it! Start-WiFiAnalyzer ``` ## Available Commands After installation, you can use any of these: **Launch the GUI:** - `Start-WiFiAnalyzer` (main command) - `Show-WiFiAnalyzerGUI` (alias) - `WiFi-Analyzer` (alias) **Other Functions:** - `Get-WiFiScan` - Scan for networks - `Get-MACAddress` - Get MAC address - `Get-ConnectedSSID` - Get current connection - `Get-ComputerInfoExtras` - Get computer info - `Analyze-ChannelCongestion` - Analyze channels - `Recommend-BestChannel` - Get channel recommendations - `Export-WiFiReport` - Export report ## Quick Test ```powershell # Test the module Import-Module WiFiAnalyzer -Force -Verbose Get-Command -Module WiFiAnalyzer # Run the analyzer Start-WiFiAnalyzer ``` ## Troubleshooting If you get "command not found": ```powershell # Check if module is loaded Get-Module WiFiAnalyzer # If not loaded, import it Import-Module WiFiAnalyzer -Force # Check where it's installed Get-Module WiFiAnalyzer -ListAvailable ``` If you get parameter errors: - Make sure you're using the FIXED version of WiFiAnalyzer.psm1 - The fixed version has the -Debug parameter removed from Start-WiFiAnalyzer ## Files Included - WiFiAnalyzer.psd1 (Module Manifest) - WiFiAnalyzer.psm1 (Module Script - FIXED) - INSTALLATION.txt (This file) ## What Was Changed in WiFiAnalyzer.psm1 1. Line 1541: Removed explicit `-Debug` parameter 2. All `if ($Debug)` statements changed to `if ($DebugPreference -eq 'Continue')` 3. All emoji characters removed (📡, 📊, 🔒, etc.) Version: 1.0.7 (Fixed) Date: October 28, 2025 |