rpsowmi 2017.4.11

Remote PowerShell over WMI (RPSoWMI)

Remote PowerShell over WMI (RPSoWMI) enables you to run PowerShell code with support of STDIN, STDOUT, STDERR and return code through Windows Management Instrumentation (WMI) on remote host.

Communication with your PowerShell code is done through 2 named pipes (one for outbound and another for inbound) being created on executor’s machine, that means your access rights must be enough privileged not only for creation of new process on remote machine but also for access to the named pipes on executor’s machine from remote machine.

How to use RPSoWMI:

from rpsowmi import RemotePowerShellOverWmi as RPSoWMI
from wmi import WMI  # https://pypi.python.org/pypi/WMI/

rps = RPSoWMI(WMI())
r = rps.execute("Write-Host 'Hello, world'")
print(r.stdout)  # Just showing 'Hello, world'.

For more details, read pydoc of rpsowmi.RemotePowerShellOverWmi.

Known problems

• Length of your PowerShell code is limited up to around 2,800 characters because the code is tranfered as a part of command line arguments.

• Line separators - CR, LF and CRLF are unified to LF (\n) somewhere in communication between RPSoWMI and your PowerShell code.

• Line separator - LF (\n) may be appended to STDOUT and STDERR even though your PowerShell code doesn’t do it.

Version history

• v2017.4.11: Initial release.

Links

• https://pypi.python.org/pypi/rpsowmi

• https://testpypi.python.org/pypi/rpsowmi