Skip to content
A PowerShell module for building, packaging and deploying AWS CloudFormation templates
Branch: master
Clone or download
scrthq !deploy v2.7.3 - Updated resource types and properties
## 2.7.3 - 2019-04-16

* Miscellaneous
  * Brought Resource Type and Property Type functions up to current spec sheet.
Latest commit ad0dfad Jun 27, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode !deploy VaporShell v2.0.0 ready for release (#16) Sep 16, 2017
Docs [skip ci] reinit local repo to resolve local errors preventing correc… Jul 2, 2017
Examples !deploy v2.7.1 with hotfix and Add-PolicyAction addition Mar 9, 2019
Tests !deploy v2.7.2 Apr 16, 2019
VaporShell deploying new release to pull in updated resource types and properties Jun 27, 2019
.gitignore pushing updates for v2.7.2 Apr 16, 2019 deploying new release to pull in updated resource types and properties Jun 27, 2019
Install-VaporShell.ps1 [skip ci] Updated README and Install-VaporShell.ps1 (#17) Sep 16, 2017
LICENSE [skip ci] update LICENSE Aug 21, 2017 pushing updated functions and fix for #44 Feb 15, 2019
_config.yml [skip ci] reinit local repo to resolve local errors preventing correc… Jul 2, 2017
azure-pipelines.yml fixed azure-pipelines.yml Mar 8, 2019
build.ps1 updated build script to install BuildHelpers v2.0.1 specifically Feb 15, 2019


📝        📦        🚀
Build | Package | Deploy
A PowerShell module for building, packaging and deploying AWS CloudFormation templates ☁️

Azure Pipelines     PowerShell Gallery - Install VaporShell     Discord - Chat      Slack - Chat     Gitter - Chat
Built with ❤︎ by Nate Ferrell. Looking for contributors!

Table of Contents


  • built from AWS's CloudFormation spec sheet: 100% coverage of all available resource and property types
  • runs on any OS: developed and tested in Windows, Ubuntu, and macOS on PowerShell v3-6
  • validates everything: built to make resulting templates reliable by leveraging parameter validation built into PowerShell
  • goes turbo: package and deploy your templates fast with one command: vsl vaporize


  • PowerShell 3+
  • .NET 4.5.0+ OR .netstandard 1.3+
    • if you have PowerShell 4 or greater, you're covered!

Recommended: AWS Labs cfn-flip

If you are working with YAML templates, you need to install cfn-flip. VaporShell uses cfn-flip under the hood to work with YAML templates, as PowerShell does not natively support YAML at this time. If you are only working in JSON, then cfn-flip isn't necessary.


[Preferred] On PowerShell 5+ or have PowerShellGet installed? Install directly from the PowerShell Gallery:

Install-Module VaporShell -Scope CurrentUser

[Alternative] Not on PowerShell 5+, can't install PowerShellGet, or policies blocking installation from remote sources? You're covered as well:

  1. Head to the Releases section in the repo
  2. Download the file attached to the latest release.
  3. If on Windows: Right-click the downloaded zip, select Properties, then unblock the file.

    This is to prevent having to unblock each file individually after unzipping.

  4. Unzip the archive.
  5. (Optional) Place the module folder somewhere in your PSModulePath.

    You can view the paths listed by running the environment variable $env:PSModulePath

  6. Import the module, using the full path to the PSD1 file in place of VaporShell if the unzipped module folder is not in your PSModulePath:
    # In $env:PSModulePath
    Import-Module VaporShell
    # Otherwise, provide the path to the manifest file:
    Import-Module -Path C:\MyPSModules\VaporShell\2.6.2\VaporShell.psd1


Working with Credentials

If you are planning on packaging or deploying to CloudFormation, you will need to setup credentials in your local Shared Credentials file. If you are using the AWS command-line interface (CLI) and already have setup credentials, then you should be ready to go.

You can update or add a credential profile with Set-VSCredential:

Set-VSCredential -AccessKey $accessKey -SecretKey $secretKey -Region USWest1 -ProfileName DevAccount

Bare Necessities

When building templates with VaporShell, there are typically a few items that you'll want to include in your build script:

  1. Create a template object by calling one of these into a variable
    • $template = Initialize-VaporShell
      • Use when starting from scratch
    • $template = Import-VaporShell -Path .\template.json
      • Use when importing from an existing template to build off of
  2. Build out your template by using the object's ScriptMethods:
    • $template.AddResource()
    • $template.AddParameter()
    • $template.AddOutput()
    • etc....
  3. Export your template to local file or stdout (useful for piping directly into New-VSStack or other functions that support TemplateBody as pipeline input)
    • Export-VaporShell -VaporshellTemplate $template -Path .\template.json
      • This will output the template as template.json in your working directory
    • Export-VaporShell -VaporshellTemplate $template
      • This will output the template to stdout as a single string
    • $template.ToJSON()
      • This script method on the template object performs the same function as Export-VaporShell -VaporshellTemplate $template and outputs the string template as JSON to stdout
    • $template.ToYAML()
      • This does the same thing as the ToJSON() script method, but outputs to YAML (cfn-flip required)


#1 Initialize a VaporShell object
$vsl = Initialize-VaporShell -Description "A function triggered on a timer."

#2 Add a Serverless function with local code as the CodeUri and a schedule of 5 minutes (split into multiple lines for readability)
$samFunction = New-SAMFunction `
    -LogicalId "ScheduledFunction" `
    -Handler "index.handler" `
    -Runtime "nodejs6.10" `
    -CodeUri ".\code" `
    -Events (Add-SAMScheduleEventSource -LogicalId Timer -Schedule "rate(5 minutes)")
$TemplateFile = ".\sched-func.yaml"

#3 Save the template as YAML using the VaporShell object's ToYAML() method (uses cfn-flip to convert to/from YAML)

<#4 Package and deploy (vsl vaporize) the template file (--tf $TemplateFile) as a change set with parameters:
    - stack name (--sn) 'sched-func'
    - S3 bucket also named 'sched-func' (defaults to the stack name if --s3 is not passed)
    - capabilities: CAPABILITY_IAM (--caps iam)
    - Verbose (--v) enabled
    - Force (--f) enabled (make sure that the bucket is created and objects are uploaded)
    - Watch (--w) the stack events in colorized output after executing the change
vsl vaporize --tf $TemplateFile --sn sched-func --caps iam --v --f --w

Check out the Examples page for more.

In Action

This is a deployment being watched via Watch-Stack $stackName to show stack creation and deletion mid-deploy: Watch-Stack in action


Apache 2.0



You can’t perform that action at this time.