scorpiox-pwsh๐ shell
Execute PowerShell commands on remote Windows machines via the DevKit REST API. Enables cross-platform remote administration from Linux or macOS.
๐ง Linux x64
๐ง Linux ARM64
๐ macOS ARM64
๐ช Windows x64
๐ก Usage Examples
Basic remote command
$ scorpiox-pwsh -H 192.168.1.50 -k myapikey -c "Get-Process | Select-Object -First 5"
Handles NPM(K) PM(K) WS(K) CPU(s) Id ProcessName
------- ------ ----- ----- ------ -- -----------
182 13 2384 5120 0.14 1024 svchost
312 22 8740 14208 1.87 2048 explorer
95 8 1680 3584 0.03 3072 conhost
System information gathering
$ scorpiox-pwsh -H win-server.local -k $DEVKIT_KEY -c "Get-ComputerInfo | Select-Object CsName, OsName, OsVersion"
$ scorpiox-pwsh -H 10.0.0.5 -k $DEVKIT_KEY -c "Get-PSDrive -PSProvider FileSystem | Format-Table Name, Used, Free -AutoSize"
Streaming long-running operations
$ scorpiox-pwsh --stream -H build-server -k $DEVKIT_KEY -c "msbuild MyProject.sln /t:Build /p:Configuration=Release"
$ scorpiox-pwsh -s -H 192.168.1.50 -k $DEVKIT_KEY -c "Get-Content C:\logs\app.log -Wait -Tail 20"
Working directory and timeout
$ scorpiox-pwsh -H win-server -k $DEVKIT_KEY -w "C:\Projects\MyApp" -c "dotnet test"
$ scorpiox-pwsh -H 10.0.0.5 -k $DEVKIT_KEY -t 60 -c "Invoke-WebRequest -Uri https://example.com/large-file.zip -OutFile C:\temp\file.zip"
Service management
$ scorpiox-pwsh -H prod-server -k $DEVKIT_KEY -c "Restart-Service -Name 'W3SVC' -Force; Get-Service 'W3SVC'"
Status Name DisplayName
------ ---- -----------
Running W3SVC World Wide Web Publishing Service
Script block execution
$ scorpiox-pwsh -H win-server -k $DEVKIT_KEY -c "\
\$drives = Get-PSDrive -PSProvider FileSystem;
foreach (\$d in \$drives) {
Write-Output \"$($d.Name): $([math]::Round($d.Free/1GB,2)) GB free\"
}"
C: 142.38 GB free
D: 487.21 GB free
Display help
$ scorpiox-pwsh --help