---
title: Microsoft Powershell
slug: connectors/microsoft-powershell
docTags: 
createdAt: 2026-06-09T16:30:30.333Z
---

The Microsoft PowerShell connector enables the execution of PowerShell scripts and commands, allowing for advanced automation and orchestration within the Swimlane ecosystem.

Microsoft PowerShell is a versatile scripting language and command-line shell designed to automate system tasks and configuration management. The Microsoft PowerShell connector for Swimlane Turbine allows users to execute PowerShell scripts directly within the Swimlane platform, enhancing automation capabilities. This integration empowers security teams to perform complex scripting actions, automate repetitive tasks, and streamline incident response workflows without leaving the Swimlane environment. By leveraging the connector, users can dynamically run scripts, process the results, and incorporate them into their security playbooks, significantly reducing manual effort and response times.

### Limitations

- File input is not directly supported. If passing files:
  Encode the contents in Base64 and decode within the script.
- Long-running scripts will be terminated after 1000 seconds.
- Script output must be serializable to JSON for structured response parsing—otherwise returned as plain string.
- The PowerShell command is provided as a raw string input via the Command parameter. The connector must treat this input as a string and pass it directly to PowerShell using the -Command argument. If multi-line scripts or special characters are used, ensure proper escaping or use Base64 encoding.

### Supported Versions

This Microsoft PowerShell connector uses the latest Version.

## Configuration

### Prerequisites

- No login credentials are needed unless your script explicitly requires them.

## Capabilities

This Connector provides the following capabilities:

- Run Powershell Script

### Run Powershell Script

- Executes a specified PowerShell command provided in the JSON body input.

# Actions

## Run Powershell Script

Executes a specified PowerShell command from the JSON body input, allowing for script automation.

### Input

| **Argument Name** | **Type** | **Required** | **Description**                                  |
| ----------------- | -------- | ------------ | ------------------------------------------------ |
| `Command`         | string   | Optional     | Specifies the PowerShell command to be executed. |

### Input Example

`{"json_body":{"Command":"Get-Date | ConvertTo-Json"}}`

### Output

| **Parameter**   | **Type** | **Description**      |
| --------------- | -------- | -------------------- |
| `output`        | string   | Output field: output |
| `error_message` | string   | Response message     |

### Output Example

`{"output":"string","error_message":"string"}`

# Response Headers

| **Header**   | **Description**                                       | **Example**                   |
| ------------ | ----------------------------------------------------- | ----------------------------- |
| Content-Type | The media type of the resource                        | application/json              |
| Date         | The date and time at which the message was originated | Thu, 01 Jan 2024 00:00:00 GMT |