# Use PowerShell scripts in Rewst
Rewst gives you two ways to work with PowerShell:
1. [**PowerShell Interpreter (Beta)**](https://docs.rewst.help/documentation/rewst-tools/powershell-interpreter) – Write and run PowerShell inline in workflows using the `#ps` block, powered by secure Azure-hosted Function Apps.
2. Stored PowerShell scripts – Run traditional PowerShell scripts on external endpoints via RMMs, typically using prebuilt automations or webhooks.
This document describes the second method — using stored PowerShell scripts to execute on endpoints via Rewst automations.
### Execute PowerShell on endpoints using stored scripts
Rewst supports running PowerShell on devices, typically through your RMM, by storing and executing scripts via webhooks. This is useful for direct device interaction such as installing software or gathering logs.
### How it works
1. Store a PowerShell [script](https://docs.rewst.help/automations/templates-and-scripts#what-is-a-script) in **Automations > Assets > Scripts**.
2. The script is assigned a unique URL ending in a GUID.
3. Call this script from a workflow or prebuilt automation, like **Run PowerShell Script on Selected Devices**.
4. Include a block in the script to send results back to Rewst.
### Return data from the script
Use `ConvertTo-Json` and `Invoke-WebRequest` to send structured data back to Rewst:
```powershell
$results = @{
hostname = $env:COMPUTERNAME
user = $env:USERNAME
}
$json = $results | ConvertTo-Json
Invoke-RestMethod -Method 'Post' -Uri $post_url -Body $json -ContentType "application/json"
```
The data returned won’t affect execution, but it enables further automation based on the results.
You can also return multiple objects by creating a PSObject to store multiple results.
```powershell
$Results = New-Object PSObject
# Add multiple values as NoteProperties
$Results | Add-Member NoteProperty "UserCreated" $True
$Results | Add-Member NoteProperty "UserName" "rjablonskis"
$Results | Add-Member NoteProperty "OrganizationalUnit" "OU=Users,DC=rewst,DC=io"
$Results | Add-Member NoteProperty "PasswordSettings" "Applied successfully"
$Results | Add-Member NoteProperty "ManagerSet" "OK"
$Results | Add-Member NoteProperty "ResultMessage" "User created successfully"
# Convert to JSON and send via POST
$postData = $Results | ConvertTo-Json
$postData = [System.Text.Encoding]::UTF8.GetBytes($postData)
Invoke-RestMethod -Uri $post_url -Method POST -Body $postData -ContentType 'application/json; charset=utf-8'
```
### Pass dynamic parameters with Jinja
Whether you're using the interpreter or calling a stored script, you can pass variables using Jinja.
#### Example: Pass a username
```powershell
$username = "{{ CTX.user.name }}"
$username.ToUpper()
```
This allows workflows to dynamically pass values into your scripts without hardcoding. Note that this example will only function correctly when the script is saved as a template.
### Use in Crates
For endpoint scripts, Rewst provides prebuilt automations such as the [Run PowerShell Script on Selected Devices](https://docs.rewst.help/documentation/crates/existing-crate-documentation/run-powershell-script-on-selected-devices-crate) Crate.
These use subworkflows to loop through device lists and run your stored script against each one.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.rewst.help/documentation/jinja/use-powershell-scripts-in-rewst.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
.png?alt=media&token=7d214d12-121d-47f4-9d1d-edfbe566b73d)
