Scripting actions

Scripting actions enable you to run blocks of code and implement custom behavior in your desktop flows.

All scripting actions follow the basic structure of the respective programming or scripting language: PowerShell, Python, VBScript, JavaScript, and C#/VB.NET.

Natural language to script powered by Copilot (preview)

[This topic is prerelease documentation and is subject to change.]

Natural language to script is a new Copilot capability added in Power Automate for desktop. It lets you quickly generate the code used in the scripting actions by just describing it in natural language. This feature is available in the following scripting actions:

• Run PowerShell
• Run VBScript
• Run DOS command
• Run Python
• Run JavaScript

Availability by region

Currently, natural language to script is available in environments located in the following regions:

• Asia Pacific
• Australia
• Brazil
• Canada
• Europe
• France
• Germany
• India
• Japan
• Norway
• Singapore
• South Africa
• South Korea
• Sweden
• Switzerland
• United Arab Emirates
• United Kingdom
• United States

Availability by account type

Currently, Copilot in Power Automate for desktop is only available for users with a work or school account.

How to generate scripts by using Copilot and natural language

To generate scripts, drag and drop one of the supported scripting actions into the designer, and then select Generate script with Copilot.

The Create prompt screen opens where you can type your natural language prompt.

To create a script, write your prompt and select Generate. If you need to recreate it, change the prompt and select Regenerate. Otherwise, select Use this script to return to the main action window, where you can modify it and add any necessary variables.

Help us improve this feature

Send feedback by selecting the thumb up or thumb down icon under the AI-generated content. When you select an icon, a feedback dialog appears that you can use to submit feedback to Microsoft.

Disabling the user feedback functionality

As a Power Platform admin, you can prevent users from sending Copilot feedback to Microsoft by using the "Copilot feedback" tenant setting.

Data subject rights requests on user feedback

Tenant administrators can view, export, and delete the feedback from their users by signing in to the Microsoft 365 admin center, and then selecting Health > Product feedback.

AI with Power Automate resources

• FAQ for Generating scripts with natural language
• Responsible AI FAQs for Power Automate
• FAQ for Copilot data security and privacy in Microsoft Power Platform

Working with variables in scripting actions

To declare variables in scripting actions and return results in Power Automate, use the following commands:

• To declare new variables in PowerShell scripts, use the $ notation. To return values from Run PowerShell script actions to Power Automate, use the Write-Output command.

  $variableName = "variableValue"
  Write-Output $variableName
  

• Python scripts don't require any special notation to declare new variables. To return values from Run Python script actions, use the print function.

  variableName = "variableValue"
  print variableName
  

• VBScript doesn't require any special notation to declare new variables. Use the WScript.Echo function to return values from Run VBScript actions to Power Automate.

  variableName = "variableValue"
  WScript.Echo variableName
  

• In JavaScript scripts, use the var notation to declare new variables and the WScript.Echo function to return values from Run JavaScript actions.

  var variableName = "variableValue";
  WScript.Echo(variableName);
  

• For .NET scripts, use the Script Parameters window, accessed through the Run .NET script action's configuration card. You can set the type of the respective variable:

In addition, you can set whether it's an input to the .NET script (In option in Direction dropdown), an output of the script (Out option in Direction dropdown) or both (In-Out option in Direction dropdown).

To use Power Automate variables in scripting actions, use the percentage notation (%) and handle the variables the same way as hardcoded values.

Run DOS command

Runs a DOS command or console application in invisible mode and returns its output when it finishes.

Input parameters

Variables produced

Exceptions

Run VBScript

Runs custom VBScript code and gets the output into a variable.

Use this action to add your own custom VBScript code to the desktop flow. You can use variables in the script to create dynamic VBScript content.

Input parameters

Variables produced

Exceptions

Run JavaScript

Runs custom JavaScript code and gets the output into a variable.

Input parameters

Variables produced

Exceptions

Run PowerShell script

Executes a custom PowerShell script and retrieves its output into a variable.

Use this action to include your own custom PowerShell code in the desktop flow. You can use variables to generate dynamic PowerShell content.

Input parameters

Variables produced

Exceptions

Run Python script

Executes Python script code and retrieves its output.

Input parameters

Variables produced

Exceptions

Run .NET script

Executes .NET (C#/VB.NET) script code and retrieves its output.

Input parameters

Variables produced

This action might produce variables, depending on the configuration you set in the Script Parameters window.

Exceptions