PowerRunner

PowerShell Script runnner that loads scripts from paths and parses commmand line parameters to present a tabbed form and output window.

Example

param (
  [string]$name = 'MyApp',
  [string]$connectionString = 'Server=myServerAddress;Database=myDataBase;Trusted_Connection=True;',
  [string][ValidateSet("Dev", "Test", "Stage", "Prod")]$environment = "Dev",
  [bool]$configure = $true,
  [switch]$revert = $false
)

$ESC = [char]27
Write-Host "Deploying $name to $environment environment."
Write-Host "$ESC[32mConnection:$ESC[0m $connectionString"
Write-Host "Configure: $configure"
Write-Host "Revert: $revert" -ForegroundColor Blue

Features

• Set all command parameters using inputs, drop downs, and checkboxes that auto-size
• Displays script description and details
• Keep track of many instances in a tabbed experience
• Scans requested directories to show heirarchical scripts in one place
• Double click a script to quickly edit and run
• Store and share saved command line parameters as a profile
• Copy current command and parameters to clipboard
• Run as administrator to execute elevated scripts
• Run scripts in their own window
• Quickly stop and start runs with a button
• Search and browse console output
• Click Edit to go directly to source
• Automatically keeps itself up to date

Setup

1. Click PowerRunnerSetup.exe from Releases to install

2. Keep the download, and click to launch it

3. Click on More info on the blue Windows prompt, then Run anyway

   

4. When the application starts for the first time, the settings page will be shown

5. Click on the folder to browse to your root directory for searching for scripts

6. Enter a pattern for search for your PowerShell scripts

   Example:

   MyProject\**\*.ps1
   

Contributing

1. Install Node.js LTS version from https://nodejs.org/en/

2. Install Yarn from https://classic.yarnpkg.com/en/docs/install/#windows-stable

3. Install Visual Studio Code from https://code.visualstudio.com/

4. Install Windows Build Tools by running the following from an elevated command prompt:

   npm install --global --production windows-build-tools

5. Clone the repository and create a new feature branch

6. Install project dependencies by running the following from the command line in the repository directory:

   yarn

7. Make any changes and submit a pull request

Creating a Release

1. Start a new feature/ branch from develop
2. Update the package.json to have the desired version
3. Complete a pull request for the feature/ branch into the develop branch
4. Create a release/ version branch from develop
5. Merge the release/ branch into master
6. Delete the release\PowerRunner-win32-x64 folder if it exists
7. Remove any versions you no longer want to support as an upgrade from release\installers\PowerRunner-win32-x64
8. Run yarn package-installer
9. Create a new release on GitHub
10. Copy the files from release\installers\PowerRunner-win32-x64 to that release

Troubleshooting

• .yarnrc must always reflect the same target as the electron version in the package.json