Using the Template

Download the Template

In the BrazenCloud portal, navigate to the Actions section using the left navigation bar.

In the Actions list find template:powershell and click it the download button on the right:

template:powershell download button

All Actions are packaged as zip file, and the template is no different. Make sure and save the Action.zip file that the portal requests to download. Then go ahead and extract it.

Inside of the Action folder you will see files called manifest.text, README.txt, runway and a folder called Windows.

Read README.txt for detailed instructions on how the Action is structured and how to modify it.

The README file may refer to an Action as an 'applet', this was the old nomenclature.

Modify the Template

With the template in hand, the easiest way to create another Action is to simply update the existing script.

Inside of the Windows\Scripts folder, you'll see a sample script called: missing_windows_patches.ps1

If you also look inside of the manifest.txt, you'll see the following commands:

COPY . .

RUN_WIN "Powershell.exe -ExecutionPolicy Bypass -File .\Windows\Scripts\missing_windows_patches.ps1"

Notice that it runs the sample script missing_windows_patches.ps1. So if you rename the sample script, make sure to also update the manifest.txt file.

For instance, if you write a PowerShell script and name it: your_script.ps1, you'll want to do two things:

1. Copy your script file and paste it into the Windows folder

2. Change manifest.txt to reference your script, as shown below

COPY . .

RUN_WIN "Powershell.exe -ExecutionPolicy Bypass -File .\Windows\Scripts\your_script.ps1"

Next Steps

Now that you have your Action written, it is time to publish it:

Build and Publish

For a more advanced and in depth take on Actions:

Overview