com.profesorfalken.jpowershell

Class PowerShell

java.lang.Object

com.profesorfalken.jpowershell.PowerShell

public class PowerShell
extends Object

Allows to open a session into PowerShell console and launch different commands.
This class cannot be directly instantiated. Instead, use the method PowerShell.openSession and call the commands using the returned instance.

Once the session is finished, call close() method in order to free the resources.

Author:

Javier Garcia Alonso

Field Summary

Fields

Modifier and Type	Field and Description
static String	END_SCRIPT_STRING

Method Summary

Modifier and Type	Method and Description
void	close() Closes all the resources used to maintain the PowerShell context
PowerShell	configuration(Map<String,String> config) Allows to override jPowerShell configuration using a map of key/value Default values are taken from file jpowershell.properties, which can be replaced just setting it on project classpath The values that can be overridden are: maxThreads: the maximum number of thread to use in pool. 3 is an optimal and default value waitPause: the pause in ms between each loop pooling for a response.
PowerShellResponse	executeCommand(String command) Launch a PowerShell command.
PowerShellResponse	executeScript(BufferedReader srcReader) Executed the provided PowerShell script in PowerShell console and gets result.
PowerShellResponse	executeScript(String scriptPath) Executed the provided PowerShell script in PowerShell console and gets result.
static PowerShellResponse	executeSingleCommand(String command) Execute a single command in PowerShell console and gets result
static PowerShell	openSession() Creates a session in PowerShell console an returns an instance which allows to execute commands in PowerShell context.
static PowerShell	openSession(String customPowerShellExecutablePath) Creates a session in PowerShell console an returns an instance which allows to execute commands in PowerShell context.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

END_SCRIPT_STRING

public static final String END_SCRIPT_STRING

See Also:

Constant Field Values

Method Detail

configuration

public PowerShell configuration(Map<String,String> config)

Allows to override jPowerShell configuration using a map of key/value
Default values are taken from file jpowershell.properties, which can be replaced just setting it on project classpath

The values that can be overridden are:

• maxThreads: the maximum number of thread to use in pool. 3 is an optimal and default value
• waitPause: the pause in ms between each loop pooling for a response. Default value is 10
• maxWait: the maximum wait in ms for the command to execute. Default value is 10000

Parameters:

config - map with the configuration in key/value format

Returns:

instance to chain

openSession

public static PowerShell openSession()
                              throws PowerShellNotAvailableException

Creates a session in PowerShell console an returns an instance which allows to execute commands in PowerShell context.
It uses the default PowerShell installation.

Returns:

an instance of the class

Throws:

PowerShellNotAvailableException - if PowerShell is not installed in the system

openSession

public static PowerShell openSession(String customPowerShellExecutablePath)
                              throws PowerShellNotAvailableException

Creates a session in PowerShell console an returns an instance which allows to execute commands in PowerShell context.
This method allows to define a PowersShell executable path different from default

Parameters:

customPowerShellExecutablePath - the path of powershell executable. If you are using the default installation path, call openSession() method instead

Returns:

an instance of the class

Throws:

PowerShellNotAvailableException - if PowerShell is not installed in the system

executeCommand

public PowerShellResponse executeCommand(String command)

Launch a PowerShell command.

This method launch a thread which will be executed in the already created PowerShell console context

Parameters:

command - the command to call. Ex: dir

Returns:

PowerShellResponse the information returned by powerShell

executeSingleCommand

public static PowerShellResponse executeSingleCommand(String command)

Execute a single command in PowerShell console and gets result

Parameters:

command - the command to execute

Returns:

response with the output of the command

executeScript

public PowerShellResponse executeScript(String scriptPath)

Executed the provided PowerShell script in PowerShell console and gets result.

Parameters:

scriptPath - the full paht of the script

Returns:

response with the output of the command

executeScript

public PowerShellResponse executeScript(BufferedReader srcReader)

Executed the provided PowerShell script in PowerShell console and gets result.

Parameters:

srcReader - the script as BufferedReader (when loading File from jar)

Returns:

response with the output of the command

close

public void close()

Closes all the resources used to maintain the PowerShell context