PowerShell Engine

Request data  

{
	"task_details": {
		"activity_name": “file”,
		"execution_path": "<PATH OF EXECUTABLE FILE>",
		"host": "<HOST_NAME>",
		"script_name": "<name of the script file>"
	},
	"credential": {
		"name": "<CREDENTIAL_NAME>"
	},
	"task_name": "pwsh_task"
}

Install WindowsApp

{
	"task_details": {
		"activity_name": "install_app",
		"execution_path": "<PATH OF EXECUTABLE FILE>",
		"host": "<HOST_NAME>",
		"file_path": "<PATH FOR THE APP TO BE INSTALLED>",
		"msi_file_name": "<NAME OF THE MSI FILE>"
	},
	"credential": {
		"name": "<CREDENTIAL_NAME>"
	},
	"task_name": "pwsh_task"
}

Uninstall WindowsApp

{
	"task_details": {
		"activity_name": "uninstall_app",
		"execution_path": "<PATH OF EXECUTABLE FILE>",
		"host": "<HOST_NAME>",
		"app_name": "<APPLICATION_NAME>"
	},
	"credential": {
		"name": "<CREDENTIAL_NAME>"
	},
	"task_name": "pwsh_task"
}

Start Service

Request data  

{
	"task_details": {
		"activity_name": "start_service",
		"execution_path": "<PATH OF EXECUTABLE FILE>",
		"host": "<HOST_NAME>",
		"service_name": "<NAME OF THE SERVICE>"
	 },
	 "credential": {
		 "name": "<CREDENTIAL_NAME>"
	 },
	"task_name": "pwsh_task"
}

Stop Service

{
	"task_details": {
		"activity_name": "stop_service",
		"execution_path": "<PATH OF EXECUTABLE FILE>",
		"host": "<HOST_NAME>",
		"service_name": "<NAME OF THE SERVICE>"
	 },
	 "credential": {
		 "name": "<CREDENTIAL_NAME>"
	 },
	"task_name": "pwsh_task"
}

Restart WindowsServer

{
      "task_details": {
            "activity_name": "restart_server",
            "execution_path": "<PATH OF EXECUTABLE FILE>",
            "host": "<HOST_NAME>"
      },
      "credential": {
            "name": "<CREDENTIAL_NAME>"
      },
      "task_name": "pwsh_task"
}

 The restart task can be performed only when no users are logged in. If any users are logged in, the restart cannot be performed. 

Troubleshooting

1. PowerShell tasks are not executing on my Windows machine. What should I check? 

• Ensure PowerShell Remoting is enabled on the target machine.
• Run the given command in PowerShell: Enable-PSRemoting
• Alternatively, verify remoting with winrm quickconfig

2. How to PowerShell scripts without using a remote session?

• Navigate to Bridge/config/powershell.properties

• Add this line, bridge.pwsh.script.execute.session=false

• Then restart the Qntrl Bridge service from Windows Services.

3. Why PowerShell task failsI even after providing the credentials?

There are a few common reasons this might happen. Check the following:

Is the credential name correct?  

Ensure the credential name matches the one provided in the request data.

Is the username formatted correctly?  

The format depends on whether the machine is part of a domain:

• If not using a domain: <hostname>\<username>

• If part of a domain: <domainname>\<username>

Is the password valid?  

• Confirm that the password is correct.

• Ensure the password is not expired or recently changed.

Test the Credentials in PowerShell  

Run the below command to manually verify if the username and password work:

Enter-PSSession -ComputerName localhost -Credential $cred

• A login prompt will appear.

• If the credentials are valid, you’ll enter the session.

• If they’re invalid, PowerShell will show an error.

4. How to debug the PowerShell script execution failure? 

• Verify the execution_path is correctly pointing to the installed PowerShell executable.

• Ensure the script_name is correct and uploaded to the task.

• Check if the host (target machine) is reachable from the Bridge-installed machine.

• Review Bridge logs under <Bridge-Path>/logs/

5. PowerShell task returns an error when installing or uninstalling an app. What can I verify? 

• Confirm the file_path and msi_file_name are correct and accessible from the target machine.

• For uninstall, ensure app_name exactly matches the installed application’s name.

6. Restart server task doesn’t work. Why? 

• Restart will fail if any user is currently logged in to the target machine.

• Ensure the machine is idle before executing the restart_server activity.

7. Services are not starting or stopping as expected. What should I do? 

• Make sure the service_name matches the actual service name (case-sensitive).

• Check that the user in the credential has permission to manage Windows services.

8. How to resolve a host or credential error while running PowerShell Engine tasks.  

• Confirm that the host IP/name is accessible from the Bridge server.

• Verify network connectivity between Bridge and the target machine.

9. Bridge seems inactive or PowerShell task doesn’t trigger. What now? 

• Restart the Qntrl Bridge service via Services (Windows) or command line.

• Review logs under <Bridge-Path>/logs/ for any errors.

• Check if PowerShell remoting or session settings are misconfigured.