Public/Intrinsic Functions/Add-FnBase64.ps1
|
function Add-FnBase64 { <# .SYNOPSIS Adds the intrinsic function "Fn::Base64" to a resource property .DESCRIPTION The intrinsic function Fn::Base64 returns the Base64 representation of the input string. This function is typically used to pass encoded data to Amazon EC2 instances by way of the UserData property. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-base64.html .PARAMETER ValueToEncode The string value you want to convert to Base64. .EXAMPLE Add-FnBase64 -ValueToEncode "AWS CloudFormation" When the template is exported, this will convert to: {"Fn::Base64":"AWS CloudFormation"} .EXAMPLE Add-FnBase64 -ValueToEncode (Add-FnRef "$_AWSRegion"") When the template is exported, this will convert to: {"Fn::Base64":{"Ref":"AWS::Region"}} .NOTES You can use any function that returns a string inside the Fn::Base64 function. .FUNCTIONALITY Vaporshell #> [OutputType('Vaporshell.Function.Base64')] [cmdletbinding()] Param ( [parameter(Mandatory = $true,Position = 0)] [ValidateScript({ $allowedTypes = "Vaporshell.Function","System.String" if ([string]$($_.PSTypeNames) -match "($(($allowedTypes|ForEach-Object{[RegEx]::Escape($_)}) -join '|'))") { $true } else { throw "The ValueToEncode parameter only accepts the following types: $($allowedTypes -join ", "). The current types of the value are: $($_.PSTypeNames -join ", ")." } })] $ValueToEncode ) $obj = [PSCustomObject][Ordered]@{ "Fn::Base64" = $ValueToEncode } $obj | Add-ObjectDetail -TypeName 'Vaporshell.Function','Vaporshell.Function.Base64' Write-Verbose "Resulting JSON from $($MyInvocation.MyCommand): `n`n`t$($obj | ConvertTo-Json -Depth 5 -Compress)`n" } |