| Version | Supported |
|---|---|
| 0.9.x | ✅ |
| < 0.9 | ❌ |
If you discover a security vulnerability in PowerPlug, please report it responsibly.
Do not open a public GitHub issue for security vulnerabilities.
Instead, please email the maintainers directly at the email address listed in the repository's author profile. Include:
- A description of the vulnerability
- Steps to reproduce the issue
- The potential impact
- Any suggested fix (if applicable)
You should receive an acknowledgment within 48 hours. We will work with you to understand the issue and coordinate a fix and disclosure timeline.
PowerPlug manipulates the user's PowerShell $PROFILE and executes commands in the current runspace. Users should be aware of the following:
- Profile modification —
New-Byname,Set-Byname, andRemove-Bynamewrite to and modify$PROFILE. Only run these cmdlets in trusted environments. - Script block execution —
Invoke-RetryandMeasure-ScriptBlockexecute user-provided script blocks. Do not pass untrusted input as script blocks. - File operations —
Move-Trash,Compare-Hash,ConvertTo-Base64, andConvertFrom-Base64operate on the file system. Paths are resolved relative to the PowerShell working directory. - Hash algorithms —
Compare-Hashsupports MD5 for legacy compatibility. MD5 is cryptographically broken and should not be used for security-critical verification. Prefer SHA256 or SHA512. - Regex timeout — All regex operations in profile manipulation use a 5-second timeout to prevent ReDoS attacks from malicious profile content.
- Network speed testing —
Get-Speedconnects to Cloudflare's speed test endpoints (speed.cloudflare.com) by default to measure download and upload speeds, and pings1.1.1.1for latency. This means data is sent to and received from Cloudflare's servers during a speed test. No personally identifiable information is transmitted beyond what is inherent to an HTTP request (source IP address, user-agent stringPowerPlug-SpeedTest/0.9.0). Custom endpoints can be specified via the-DownloadUrl,-UploadUrl, and-LatencyHostparameters if you prefer not to use Cloudflare. Upload payloads are randomly generated bytes with no user data.
- Ampere (0.9.2) — Utility library by the same author. Reviewed and trusted.
- PowerShellStandard.Library (5.1.1) — Official Microsoft package for building PowerShell modules.