PSCloudFormation.netcore

2.2.2

Private/ArgumentHandling/New-StackOperationArguments.ps1

function New-StackOperationArguments
{
    <#
    .SYNOPSIS
        Create an argument hash of parameters needed by New-CFNStack and Update-CFNStack

    .PARAMETER StackName
        Name of stack to create/update

    .PARAMETER TemplateLocation
        May be one of
        - Local file. File is read and used to build a -TemplateBody argument
        - S3 URI (which is converted to HTTPS URI for the current region) and builds -TemplateURL argument
          Note that this only works if a default region is set in the shell and
          you don't try to point to a different region with -Region
        - https URL. URL is used as-is to build -TemplateURL argument

    .PARAMETER Capabilities
        IAM Capability for -Capability argument

    .PARAMETER StackParameters
        Array of template parameters for -Parameter argument

    .PARAMETER CredentialArguments
        Credential arguments passed to public function.

    .PARAMETER UsePreviousTemplate
        Setting of -UsePreviousTemplate if updating; else $false

    .OUTPUTS
        [hashtable] Argument hash to splat New-CFNStack/Update-CFNStack
    #>
    param
    (
        [Parameter(Mandatory = $true)]
        [string]$StackName,

        [string]$TemplateLocation,

        [string[]]$Capabilities,

        [object]$StackParameters,

        [hashtable]$CredentialArguments,

        [bool]$UsePreviousTemplate = $false
    )

    $stackArgs = @{

        'StackName' = $StackName
    }

    $template = New-TemplateResolver -TemplateLocation $TemplateLocation -StackName $stackName -UsePreviousTemplate $UsePreviousTemplate -CredentialArguments $CredentialArguments

    if ($template.Type -ieq 'File')
    {
        $stackArgs.Add('TemplateBody', $template.ReadTemplate())

        # Copy the template to S3 if too large
        Copy-OversizeTemplateToS3 -TemplateLocation $TemplateLocation -StackArguments $stackArgs -CredentialArguments $CredentialArguments
    }
    elseif ($template.Type -ieq 'UsePreviousTemplate')
    {
        $stackArgs.Add('UsePreviousTemplate', $true)
    }
    else
    {
        $stackArgs.Add('TemplateURL', $template.Url)
    }

    if (($Capabilities | Measure-Object).Count -gt 0)
    {
        $stackArgs.Add('Capabilities', $Capabilities)
    }

    if (($stackParameters | Measure-Object).Count -gt 0)
    {
        $stackArgs.Add('Parameter', $stackParameters)
    }

    $stackArgs
}