c1df35ef4a
Added detailed usage instructions, installation steps, and features for the ProcessStats PowerShell module.
99 lines
1.8 KiB
Markdown
99 lines
1.8 KiB
Markdown
# ProcessStats
|
|
|
|
PowerShell module to analyze **duplicate processes** on your system:
|
|
- Memory usage (`Get-ProcessMemory`)
|
|
- CPU usage (`Get-ProcessCPU`)
|
|
|
|
---
|
|
|
|
## Features
|
|
|
|
- Lists processes that have **more than one instance running**
|
|
- Summarizes:
|
|
- Total memory usage (MB)
|
|
- Total CPU usage (%)
|
|
- Sorts output descending
|
|
- Cross-machine and script-friendly
|
|
- Easy CSV export
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
### 1. Install locally from GitHub
|
|
|
|
1. Clone the repository:
|
|
|
|
`git clone https://github.com/iminet/ProcessStats.git`
|
|
|
|
2. Import the module:
|
|
|
|
`Import-Module "C:\WhereverYouCloned\ProcessStats\ProcessStats.psm1" -Force`
|
|
|
|
3. Verify:
|
|
|
|
Get-Module
|
|
Get-Command -Module ProcessStats
|
|
|
|
## 2. Install from PowerShell Gallery
|
|
|
|
Future plan...
|
|
|
|
---
|
|
|
|
## Usage
|
|
### Memory Usage
|
|
```powershell
|
|
# Show all processes with 2+ instances
|
|
Get-ProcessMemory
|
|
|
|
# Show processes with 3+ instances
|
|
Get-ProcessMemory -MinCount 3
|
|
```
|
|
|
|
Example output:
|
|
```powershell
|
|
Count Name Memory Sum in MB
|
|
----- ---- ----------------
|
|
12 chrome 1845.327
|
|
3 dotnet 412.889
|
|
2 explorer 153.214
|
|
```
|
|
|
|
|
|
### CPU Usage
|
|
```powershell
|
|
# Show all processes with 2+ instances
|
|
Get-DuplicateProcessCPU
|
|
|
|
# Show processes with 3+ instances
|
|
Get-DuplicateProcessCPU -MinCount 3
|
|
```
|
|
|
|
Example output:
|
|
```powershell
|
|
Count Name CPU Total (%)
|
|
----- ---- -------------
|
|
12 chrome 23.45
|
|
3 dotnet 7.89
|
|
2 explorer 1.25
|
|
```
|
|
---
|
|
|
|
## License
|
|
|
|
MIT License. See LICENSE file for details.
|
|
Free to use, modify, and distribute
|
|
Attribution appreciated
|
|
Compatible with commercial and open-source projects
|
|
|
|
---
|
|
|
|
## Notes
|
|
|
|
Works on PowerShell 5.1 and PowerShell 7+
|
|
|
|
Designed for Windows systems, but cmdlets are compatible with Linux/macOS PowerShell if Get-Process outputs are available
|
|
|
|
Recommended for system monitoring, scripting, and identifying memory/CPU bottlenecks from duplicate processes
|