sshmitm.clients.powershell module

class sshmitm.clients.powershell.PowerShellClient(host, port, method, password, user, key, session)

Bases: SSHClient

SSH client used to connect to a remote host with the PowerShell remoting subsystem.

PowerShell remoting over SSH (PSRP) is started on the remote host with pwsh -sshs registered as the powershell SSH subsystem. This client reuses the transport of an already authenticated SSHClient and only tracks how many subsystem channels are currently active.

Parameters:

• host (str) – the hostname or IP address of the remote host

• port (int) – the port number to connect to on the remote host

• method (AuthenticationMethod) – the authentication method to use when connecting

• password (str | None) – the password to use for authentication (if method is password)

• user (str) – the username to use for authentication

• key (PKey | None) – the public key to use for authentication (if method is publickey)

• session (Session) – the session instance

close()

Return type:

None

classmethod from_client(ssh_client)

Create a PowerShellClient instance from an SSHClient instance.

Parameters:

ssh_client (SSHClient | None) – The SSHClient instance.

Return type:

Optional[PowerShellClient]

Returns:

A PowerShellClient instance, or None if it could not be created.

property running: bool

Indicate whether the powershell client is running.

Returns:

Whether the powershell client is running.