VaporShell.ElasticLoadBalancing.psm1
|
# PSM1 Contents function Format-Json { [CmdletBinding()] Param ( [Parameter(Mandatory = $true, Position = 0, ValueFromPipeline = $true)] [String] $Json ) Begin { $cleaner = { param([String]$Line) Process{ [Regex]::Replace( $Line, "\\u(?<Value>[a-zA-Z0-9]{4})", { param($m)([char]([int]::Parse( $m.Groups['Value'].Value, [System.Globalization.NumberStyles]::HexNumber ))).ToString() } ) } } } Process { if ($PSVersionTable.PSVersion.Major -lt 6) { try { $indent = 0; $res = $Json -split '\n' | ForEach-Object { if ($_ -match '[\}\]]') { # This line contains ] or }, decrement the indentation level $indent-- } $line = (' ' * $indent * 2) + $_.TrimStart().Replace(': ', ': ') if ($_ -match '[\{\[]') { # This line contains [ or {, increment the indentation level $indent++ } $cleaner.Invoke($line) } $res -join "`n" } catch { ($Json -split '\n' | ForEach-Object {$cleaner.Invoke($_)}) -join "`n" } } else { ($Json -split '\n' | ForEach-Object {$cleaner.Invoke($_)}) -join "`n" } } } function Get-TrueCount { Param ( [parameter(Mandatory = $false,Position = 0,ValueFromPipeline = $true)] $Array ) Process { if ($array) { if ($array.Count) { $count = $array.Count } else { $count = 1 } } else { $count = 0 } } End { return $count } } function New-VSError { <# .SYNOPSIS Error generator function to use in tandem with $PSCmdlet.ThrowTerminatingError() .PARAMETER Result Allows input of an error from AWS SDK, resulting in the Exception message being parsed out. .PARAMETER String Used to create basic String message errors in the same wrapper #> [cmdletbinding(DefaultParameterSetName="Result")] param( [parameter(Position=0,ParameterSetName="Result")] $Result, [parameter(Position=0,ParameterSetName="String")] $String ) switch ($PSCmdlet.ParameterSetName) { Result { $Exception = "$($result.Exception.InnerException.Message)" } String { $Exception = "$String" } } $e = New-Object "System.Exception" $Exception $errorRecord = New-Object 'System.Management.Automation.ErrorRecord' $e, $null, ([System.Management.Automation.ErrorCategory]::InvalidOperation), $null return $errorRecord } function ResolveS3Endpoint { <# .SYNOPSIS Resolves the S3 endpoint most appropriate for each region. #> Param ( [parameter(Mandatory=$true,Position=0)] [ValidateSet("eu-west-2","ap-south-1","us-east-2","sa-east-1","us-west-1","us-west-2","eu-west-1","ap-southeast-2","ca-central-1","ap-northeast-2","us-east-1","eu-central-1","ap-southeast-1","ap-northeast-1")] [String] $Region ) $endpointMap = @{ "us-east-2" = "s3.us-east-2.amazonaws.com" "us-east-1" = "s3.amazonaws.com" "us-west-1" = "s3-us-west-1.amazonaws.com" "us-west-2" = "s3-us-west-2.amazonaws.com" "ca-central-1" = "s3.ca-central-1.amazonaws.com" "ap-south-1" = "s3.ap-south-1.amazonaws.com" "ap-northeast-2" = "s3.ap-northeast-2.amazonaws.com" "ap-southeast-1" = "s3-ap-southeast-1.amazonaws.com" "ap-southeast-2" = "s3-ap-southeast-2.amazonaws.com" "ap-northeast-1" = "s3-ap-northeast-1.amazonaws.com" "eu-central-1" = "s3.eu-central-1.amazonaws.com" "eu-west-1" = "s3-eu-west-1.amazonaws.com" "eu-west-2" = "s3.eu-west-2.amazonaws.com" "sa-east-1" = "s3-sa-east-1.amazonaws.com" } return $endpointMap[$Region] } function Add-VSElasticLoadBalancingLoadBalancerAccessLoggingPolicy { <# .SYNOPSIS Adds an AWS::ElasticLoadBalancing::LoadBalancer.AccessLoggingPolicy resource property to the template. Specifies where and how access logs are stored for your Classic Load Balancer. .DESCRIPTION Adds an AWS::ElasticLoadBalancing::LoadBalancer.AccessLoggingPolicy resource property to the template. Specifies where and how access logs are stored for your Classic Load Balancer. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-accessloggingpolicy.html .PARAMETER EmitInterval The interval for publishing the access logs. You can specify an interval of either 5 minutes or 60 minutes. Default: 60 minutes Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-accessloggingpolicy.html#cfn-elb-accessloggingpolicy-emitinterval PrimitiveType: Integer UpdateType: Mutable .PARAMETER Enabled Specifies whether access logs are enabled for the load balancer. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-accessloggingpolicy.html#cfn-elb-accessloggingpolicy-enabled PrimitiveType: Boolean UpdateType: Mutable .PARAMETER S3BucketName The name of the Amazon S3 bucket where the access logs are stored. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-accessloggingpolicy.html#cfn-elb-accessloggingpolicy-s3bucketname PrimitiveType: String UpdateType: Mutable .PARAMETER S3BucketPrefix The logical hierarchy you created for your Amazon S3 bucket, for example my-bucket-prefix/prod. If the prefix is not provided, the log is placed at the root level of the bucket. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-accessloggingpolicy.html#cfn-elb-accessloggingpolicy-s3bucketprefix PrimitiveType: String UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([ElasticLoadBalancingLoadBalancerAccessLoggingPolicy])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] [object] $EmitInterval, [parameter(Mandatory = $true)] [object] $Enabled, [parameter(Mandatory = $true)] [object] $S3BucketName, [parameter(Mandatory = $false)] [object] $S3BucketPrefix ) Process { $obj = [ElasticLoadBalancingLoadBalancerAccessLoggingPolicy]::new($PSBoundParameters) Write-Debug "$($MyInvocation.MyCommand) PSBoundParameters:`n$($PSBoundParameters | ConvertTo-Json -Depth 20 | Format-Json)" Write-Verbose "Resulting object from $($MyInvocation.MyCommand): `n$($obj.ToJson() | Format-Json)" $obj } } Export-ModuleMember -Function 'Add-VSElasticLoadBalancingLoadBalancerAccessLoggingPolicy' function Add-VSElasticLoadBalancingLoadBalancerAppCookieStickinessPolicy { <# .SYNOPSIS Adds an AWS::ElasticLoadBalancing::LoadBalancer.AppCookieStickinessPolicy resource property to the template. Specifies a policy for application-controlled session stickiness for your Classic Load Balancer. .DESCRIPTION Adds an AWS::ElasticLoadBalancing::LoadBalancer.AppCookieStickinessPolicy resource property to the template. Specifies a policy for application-controlled session stickiness for your Classic Load Balancer. To associate a policy with a listener, use the PolicyNames: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html#cfn-ec2-elb-listener-policynames property for the listener. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-AppCookieStickinessPolicy.html .PARAMETER CookieName The name of the application cookie used for stickiness. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-AppCookieStickinessPolicy.html#cfn-elb-appcookiestickinesspolicy-cookiename PrimitiveType: String UpdateType: Mutable .PARAMETER PolicyName The mnemonic name for the policy being created. The name must be unique within a set of policies for this load balancer. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-AppCookieStickinessPolicy.html#cfn-elb-appcookiestickinesspolicy-policyname PrimitiveType: String UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([ElasticLoadBalancingLoadBalancerAppCookieStickinessPolicy])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] [object] $CookieName, [parameter(Mandatory = $true)] [object] $PolicyName ) Process { $obj = [ElasticLoadBalancingLoadBalancerAppCookieStickinessPolicy]::new($PSBoundParameters) Write-Debug "$($MyInvocation.MyCommand) PSBoundParameters:`n$($PSBoundParameters | ConvertTo-Json -Depth 20 | Format-Json)" Write-Verbose "Resulting object from $($MyInvocation.MyCommand): `n$($obj.ToJson() | Format-Json)" $obj } } Export-ModuleMember -Function 'Add-VSElasticLoadBalancingLoadBalancerAppCookieStickinessPolicy' function Add-VSElasticLoadBalancingLoadBalancerConnectionDrainingPolicy { <# .SYNOPSIS Adds an AWS::ElasticLoadBalancing::LoadBalancer.ConnectionDrainingPolicy resource property to the template. Specifies the connection draining settings for your Classic Load Balancer. .DESCRIPTION Adds an AWS::ElasticLoadBalancing::LoadBalancer.ConnectionDrainingPolicy resource property to the template. Specifies the connection draining settings for your Classic Load Balancer. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-connectiondrainingpolicy.html .PARAMETER Enabled Specifies whether connection draining is enabled for the load balancer. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-connectiondrainingpolicy.html#cfn-elb-connectiondrainingpolicy-enabled PrimitiveType: Boolean UpdateType: Mutable .PARAMETER Timeout The maximum time, in seconds, to keep the existing connections open before deregistering the instances. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-connectiondrainingpolicy.html#cfn-elb-connectiondrainingpolicy-timeout PrimitiveType: Integer UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([ElasticLoadBalancingLoadBalancerConnectionDrainingPolicy])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] [object] $Enabled, [parameter(Mandatory = $false)] [object] $Timeout ) Process { $obj = [ElasticLoadBalancingLoadBalancerConnectionDrainingPolicy]::new($PSBoundParameters) Write-Debug "$($MyInvocation.MyCommand) PSBoundParameters:`n$($PSBoundParameters | ConvertTo-Json -Depth 20 | Format-Json)" Write-Verbose "Resulting object from $($MyInvocation.MyCommand): `n$($obj.ToJson() | Format-Json)" $obj } } Export-ModuleMember -Function 'Add-VSElasticLoadBalancingLoadBalancerConnectionDrainingPolicy' function Add-VSElasticLoadBalancingLoadBalancerConnectionSettings { <# .SYNOPSIS Adds an AWS::ElasticLoadBalancing::LoadBalancer.ConnectionSettings resource property to the template. Specifies the idle timeout value for your Classic Load Balancer. .DESCRIPTION Adds an AWS::ElasticLoadBalancing::LoadBalancer.ConnectionSettings resource property to the template. Specifies the idle timeout value for your Classic Load Balancer. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-connectionsettings.html .PARAMETER IdleTimeout The time, in seconds, that the connection is allowed to be idle no data has been sent over the connection before it is closed by the load balancer. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-connectionsettings.html#cfn-elb-connectionsettings-idletimeout PrimitiveType: Integer UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([ElasticLoadBalancingLoadBalancerConnectionSettings])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] [object] $IdleTimeout ) Process { $obj = [ElasticLoadBalancingLoadBalancerConnectionSettings]::new($PSBoundParameters) Write-Debug "$($MyInvocation.MyCommand) PSBoundParameters:`n$($PSBoundParameters | ConvertTo-Json -Depth 20 | Format-Json)" Write-Verbose "Resulting object from $($MyInvocation.MyCommand): `n$($obj.ToJson() | Format-Json)" $obj } } Export-ModuleMember -Function 'Add-VSElasticLoadBalancingLoadBalancerConnectionSettings' function Add-VSElasticLoadBalancingLoadBalancerHealthCheck { <# .SYNOPSIS Adds an AWS::ElasticLoadBalancing::LoadBalancer.HealthCheck resource property to the template. Specifies health check settings for your Classic Load Balancer. .DESCRIPTION Adds an AWS::ElasticLoadBalancing::LoadBalancer.HealthCheck resource property to the template. Specifies health check settings for your Classic Load Balancer. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-health-check.html .PARAMETER HealthyThreshold The number of consecutive health checks successes required before moving the instance to the Healthy state. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-health-check.html#cfn-elb-healthcheck-healthythreshold PrimitiveType: String UpdateType: Mutable .PARAMETER Interval The approximate interval, in seconds, between health checks of an individual instance. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-health-check.html#cfn-elb-healthcheck-interval PrimitiveType: String UpdateType: Mutable .PARAMETER Target The instance being checked. The protocol is either TCP, HTTP, HTTPS, or SSL. The range of valid ports is one 1 through 65535. TCP is the default, specified as a TCP: port pair, for example "TCP:5000". In this case, a health check simply attempts to open a TCP connection to the instance on the specified port. Failure to connect within the configured timeout is considered unhealthy. SSL is also specified as SSL: port pair, for example, SSL:5000. For HTTP/HTTPS, you must include a ping path in the string. HTTP is specified as a HTTP:port;/;PathToPing; grouping, for example "HTTP:80/weather/us/wa/seattle". In this case, a HTTP GET request is issued to the instance on the given port and path. Any answer other than "200 OK" within the timeout period is considered unhealthy. The total length of the HTTP ping target must be 1024 16-bit Unicode characters or less. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-health-check.html#cfn-elb-healthcheck-target PrimitiveType: String UpdateType: Mutable .PARAMETER Timeout The amount of time, in seconds, during which no response means a failed health check. This value must be less than the Interval value. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-health-check.html#cfn-elb-healthcheck-timeout PrimitiveType: String UpdateType: Mutable .PARAMETER UnhealthyThreshold The number of consecutive health check failures required before moving the instance to the Unhealthy state. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-health-check.html#cfn-elb-healthcheck-unhealthythreshold PrimitiveType: String UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([ElasticLoadBalancingLoadBalancerHealthCheck])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] [object] $HealthyThreshold, [parameter(Mandatory = $true)] [object] $Interval, [parameter(Mandatory = $true)] [object] $Target, [parameter(Mandatory = $true)] [object] $Timeout, [parameter(Mandatory = $true)] [object] $UnhealthyThreshold ) Process { $obj = [ElasticLoadBalancingLoadBalancerHealthCheck]::new($PSBoundParameters) Write-Debug "$($MyInvocation.MyCommand) PSBoundParameters:`n$($PSBoundParameters | ConvertTo-Json -Depth 20 | Format-Json)" Write-Verbose "Resulting object from $($MyInvocation.MyCommand): `n$($obj.ToJson() | Format-Json)" $obj } } Export-ModuleMember -Function 'Add-VSElasticLoadBalancingLoadBalancerHealthCheck' function Add-VSElasticLoadBalancingLoadBalancerLBCookieStickinessPolicy { <# .SYNOPSIS Adds an AWS::ElasticLoadBalancing::LoadBalancer.LBCookieStickinessPolicy resource property to the template. Specifies a policy for duration-based session stickiness for your Classic Load Balancer. .DESCRIPTION Adds an AWS::ElasticLoadBalancing::LoadBalancer.LBCookieStickinessPolicy resource property to the template. Specifies a policy for duration-based session stickiness for your Classic Load Balancer. To associate a policy with a listener, use the PolicyNames: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html#cfn-ec2-elb-listener-policynames property for the listener. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-LBCookieStickinessPolicy.html .PARAMETER CookieExpirationPeriod The time period, in seconds, after which the cookie should be considered stale. If this parameter is not specified, the stickiness session lasts for the duration of the browser session. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-LBCookieStickinessPolicy.html#cfn-elb-lbcookiestickinesspolicy-cookieexpirationperiod PrimitiveType: String UpdateType: Mutable .PARAMETER PolicyName The name of the policy. This name must be unique within the set of policies for this load balancer. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-LBCookieStickinessPolicy.html#cfn-elb-lbcookiestickinesspolicy-policyname PrimitiveType: String UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([ElasticLoadBalancingLoadBalancerLBCookieStickinessPolicy])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] [object] $CookieExpirationPeriod, [parameter(Mandatory = $false)] [object] $PolicyName ) Process { $obj = [ElasticLoadBalancingLoadBalancerLBCookieStickinessPolicy]::new($PSBoundParameters) Write-Debug "$($MyInvocation.MyCommand) PSBoundParameters:`n$($PSBoundParameters | ConvertTo-Json -Depth 20 | Format-Json)" Write-Verbose "Resulting object from $($MyInvocation.MyCommand): `n$($obj.ToJson() | Format-Json)" $obj } } Export-ModuleMember -Function 'Add-VSElasticLoadBalancingLoadBalancerLBCookieStickinessPolicy' function Add-VSElasticLoadBalancingLoadBalancerListeners { <# .SYNOPSIS Adds an AWS::ElasticLoadBalancing::LoadBalancer.Listeners resource property to the template. Specifies a listener for your Classic Load Balancer. .DESCRIPTION Adds an AWS::ElasticLoadBalancing::LoadBalancer.Listeners resource property to the template. Specifies a listener for your Classic Load Balancer. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html .PARAMETER InstancePort The port on which the instance is listening. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html#cfn-ec2-elb-listener-instanceport PrimitiveType: String UpdateType: Mutable .PARAMETER InstanceProtocol The protocol to use for routing traffic to instances: HTTP, HTTPS, TCP, or SSL. If the front-end protocol is TCP or SSL, the back-end protocol must be TCP or SSL. If the front-end protocol is HTTP or HTTPS, the back-end protocol must be HTTP or HTTPS. If there is another listener with the same InstancePort whose InstanceProtocol is secure, HTTPS or SSL, the listener's InstanceProtocol must also be secure. If there is another listener with the same InstancePort whose InstanceProtocol is HTTP or TCP, the listener's InstanceProtocol must be HTTP or TCP. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html#cfn-ec2-elb-listener-instanceprotocol PrimitiveType: String UpdateType: Mutable .PARAMETER LoadBalancerPort The port on which the load balancer is listening. On EC2-VPC, you can specify any port from the range 1-65535. On EC2-Classic, you can specify any port from the following list: 25, 80, 443, 465, 587, 1024-65535. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html#cfn-ec2-elb-listener-loadbalancerport PrimitiveType: String UpdateType: Mutable .PARAMETER PolicyNames The names of the policies to associate with the listener. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html#cfn-ec2-elb-listener-policynames DuplicatesAllowed: False PrimitiveItemType: String Type: List UpdateType: Mutable .PARAMETER Protocol The load balancer transport protocol to use for routing: HTTP, HTTPS, TCP, or SSL. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html#cfn-ec2-elb-listener-protocol PrimitiveType: String UpdateType: Mutable .PARAMETER SSLCertificateId The Amazon Resource Name ARN of the server certificate. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html#cfn-ec2-elb-listener-sslcertificateid PrimitiveType: String UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([ElasticLoadBalancingLoadBalancerListeners])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] [object] $InstancePort, [parameter(Mandatory = $false)] [object] $InstanceProtocol, [parameter(Mandatory = $true)] [object] $LoadBalancerPort, [parameter(Mandatory = $false)] $PolicyNames, [parameter(Mandatory = $true)] [object] $Protocol, [parameter(Mandatory = $false)] [object] $SSLCertificateId ) Process { $obj = [ElasticLoadBalancingLoadBalancerListeners]::new($PSBoundParameters) Write-Debug "$($MyInvocation.MyCommand) PSBoundParameters:`n$($PSBoundParameters | ConvertTo-Json -Depth 20 | Format-Json)" Write-Verbose "Resulting object from $($MyInvocation.MyCommand): `n$($obj.ToJson() | Format-Json)" $obj } } Export-ModuleMember -Function 'Add-VSElasticLoadBalancingLoadBalancerListeners' function Add-VSElasticLoadBalancingLoadBalancerPolicies { <# .SYNOPSIS Adds an AWS::ElasticLoadBalancing::LoadBalancer.Policies resource property to the template. Specifies policies for your Classic Load Balancer. .DESCRIPTION Adds an AWS::ElasticLoadBalancing::LoadBalancer.Policies resource property to the template. Specifies policies for your Classic Load Balancer. To associate policies with a listener, use the PolicyNames: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-listener.html#cfn-ec2-elb-listener-policynames property for the listener. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-policy.html .PARAMETER Attributes The policy attributes. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-policy.html#cfn-ec2-elb-policy-attributes DuplicatesAllowed: False PrimitiveItemType: Json Type: List UpdateType: Mutable .PARAMETER InstancePorts The instance ports for the policy. Required only for some policy types. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-policy.html#cfn-ec2-elb-policy-instanceports DuplicatesAllowed: False PrimitiveItemType: String Type: List UpdateType: Mutable .PARAMETER LoadBalancerPorts The load balancer ports for the policy. Required only for some policy types. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-policy.html#cfn-ec2-elb-policy-loadbalancerports DuplicatesAllowed: False PrimitiveItemType: String Type: List UpdateType: Mutable .PARAMETER PolicyName The name of the policy. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-policy.html#cfn-ec2-elb-policy-policyname PrimitiveType: String UpdateType: Mutable .PARAMETER PolicyType The name of the policy type. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb-policy.html#cfn-ec2-elb-policy-policytype PrimitiveType: String UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([ElasticLoadBalancingLoadBalancerPolicies])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] $Attributes, [parameter(Mandatory = $false)] $InstancePorts, [parameter(Mandatory = $false)] $LoadBalancerPorts, [parameter(Mandatory = $true)] [object] $PolicyName, [parameter(Mandatory = $true)] [object] $PolicyType ) Process { $obj = [ElasticLoadBalancingLoadBalancerPolicies]::new($PSBoundParameters) Write-Debug "$($MyInvocation.MyCommand) PSBoundParameters:`n$($PSBoundParameters | ConvertTo-Json -Depth 20 | Format-Json)" Write-Verbose "Resulting object from $($MyInvocation.MyCommand): `n$($obj.ToJson() | Format-Json)" $obj } } Export-ModuleMember -Function 'Add-VSElasticLoadBalancingLoadBalancerPolicies' function New-VSElasticLoadBalancingLoadBalancer { <# .SYNOPSIS Adds an AWS::ElasticLoadBalancing::LoadBalancer resource to the template. Specifies a Classic Load Balancer. .DESCRIPTION Adds an AWS::ElasticLoadBalancing::LoadBalancer resource to the template. Specifies a Classic Load Balancer. You can specify the AvailabilityZones or Subnets property, but not both. If this resource has a public IP address and is also in a VPC that is defined in the same template, you must use the DependsOn attribute: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-dependson.html to declare a dependency on the VPC-gateway attachment. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html .PARAMETER LogicalId The logical ID must be alphanumeric (A-Za-z0-9) and unique within the template. Use the logical name to reference the resource in other parts of the template. For example, if you want to map an Amazon Elastic Block Store volume to an Amazon EC2 instance, you reference the logical IDs to associate the block stores with the instance. .PARAMETER AccessLoggingPolicy Information about where and how access logs are stored for the load balancer. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-accessloggingpolicy Type: AccessLoggingPolicy UpdateType: Mutable .PARAMETER AppCookieStickinessPolicy Information about a policy for application-controlled session stickiness. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-appcookiestickinesspolicy DuplicatesAllowed: False ItemType: AppCookieStickinessPolicy Type: List UpdateType: Mutable .PARAMETER AvailabilityZones The Availability Zones for the load balancer. For load balancers in a VPC, specify Subnets instead. Update requires replacement if you did not previously specify an Availability Zone or if you are removing all Availability Zones. Otherwise, update requires no interruption. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-availabilityzones DuplicatesAllowed: False PrimitiveItemType: String Type: List UpdateType: Conditional .PARAMETER ConnectionDrainingPolicy If enabled, the load balancer allows existing requests to complete before the load balancer shifts traffic away from a deregistered or unhealthy instance. For more information, see Configure Connection Draining: https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-conn-drain.html in the *Classic Load Balancers Guide*. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-connectiondrainingpolicy Type: ConnectionDrainingPolicy UpdateType: Mutable .PARAMETER ConnectionSettings If enabled, the load balancer allows the connections to remain idle no data is sent over the connection for the specified duration. By default, Elastic Load Balancing maintains a 60-second idle connection timeout for both front-end and back-end connections of your load balancer. For more information, see Configure Idle Connection Timeout: https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/config-idle-timeout.html in the *Classic Load Balancers Guide*. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-connectionsettings Type: ConnectionSettings UpdateType: Mutable .PARAMETER CrossZone If enabled, the load balancer routes the request traffic evenly across all instances regardless of the Availability Zones. For more information, see Configure Cross-Zone Load Balancing: https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-disable-crosszone-lb.html in the *Classic Load Balancers Guide*. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-crosszone PrimitiveType: Boolean UpdateType: Mutable .PARAMETER HealthCheck The health check settings to use when evaluating the health of your EC2 instances. Update requires replacement if you did not previously specify health check settings or if you are removing the health check settings. Otherwise, update requires no interruption. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-healthcheck Type: HealthCheck UpdateType: Conditional .PARAMETER Instances The IDs of the instances for the load balancer. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-instances DuplicatesAllowed: False PrimitiveItemType: String Type: List UpdateType: Mutable .PARAMETER LBCookieStickinessPolicy Information about a policy for duration-based session stickiness. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-lbcookiestickinesspolicy DuplicatesAllowed: False ItemType: LBCookieStickinessPolicy Type: List UpdateType: Mutable .PARAMETER Listeners The listeners for the load balancer. You can specify at most one listener per port. If you update the properties for a listener, AWS CloudFormation deletes the existing listener and creates a new one with the specified properties. While the new listener is being created, clients cannot connect to the load balancer. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-listeners DuplicatesAllowed: False ItemType: Listeners Type: List UpdateType: Mutable .PARAMETER LoadBalancerName The name of the load balancer. This name must be unique within your set of load balancers for the region. If you don't specify a name, AWS CloudFormation generates a unique physical ID for the load balancer. For more information, see Name Type: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html. If you specify a name, you cannot perform updates that require replacement of this resource, but you can perform other updates. To replace the resource, specify a new name. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-elbname PrimitiveType: String UpdateType: Immutable .PARAMETER Policies The policies defined for your Classic Load Balancer. Specify only back-end server policies. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-policies DuplicatesAllowed: False ItemType: Policies Type: List UpdateType: Mutable .PARAMETER Scheme The type of load balancer. Valid only for load balancers in a VPC. If Scheme is internet-facing, the load balancer has a public DNS name that resolves to a public IP address. If Scheme is internal, the load balancer has a public DNS name that resolves to a private IP address. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-scheme PrimitiveType: String UpdateType: Immutable .PARAMETER SecurityGroups The security groups for the load balancer. Valid only for load balancers in a VPC. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-securitygroups DuplicatesAllowed: False PrimitiveItemType: String Type: List UpdateType: Mutable .PARAMETER Subnets The IDs of the subnets for the load balancer. You can specify at most one subnet per Availability Zone. Update requires replacement if you did not previously specify a subnet or if you are removing all subnets. Otherwise, update requires no interruption. To update to a different subnet in the current Availability Zone, you must first update to a subnet in a different Availability Zone, then update to the new subnet in the original Availability Zone. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-ec2-elb-subnets DuplicatesAllowed: False PrimitiveItemType: String Type: List UpdateType: Conditional .PARAMETER Tags The tags associated with a load balancer. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-elb.html#cfn-elasticloadbalancing-loadbalancer-tags DuplicatesAllowed: True ItemType: Tag Type: List UpdateType: Mutable .PARAMETER DeletionPolicy With the DeletionPolicy attribute you can preserve or (in some cases) backup a resource when its stack is deleted. You specify a DeletionPolicy attribute for each resource that you want to control. If a resource has no DeletionPolicy attribute, AWS CloudFormation deletes the resource by default. To keep a resource when its stack is deleted, specify Retain for that resource. You can use retain for any resource. For example, you can retain a nested stack, S3 bucket, or EC2 instance so that you can continue to use or modify those resources after you delete their stacks. You must use one of the following options: "Delete","Retain","Snapshot" .PARAMETER UpdateReplacePolicy Use the UpdateReplacePolicy attribute to retain or (in some cases) backup the existing physical instance of a resource when it is replaced during a stack update operation. When you initiate a stack update, AWS CloudFormation updates resources based on differences between what you submit and the stack's current template and parameters. If you update a resource property that requires that the resource be replaced, AWS CloudFormation recreates the resource during the update. Recreating the resource generates a new physical ID. AWS CloudFormation creates the replacement resource first, and then changes references from other dependent resources to point to the replacement resource. By default, AWS CloudFormation then deletes the old resource. Using the UpdateReplacePolicy, you can specify that AWS CloudFormation retain or (in some cases) create a snapshot of the old resource. For resources that support snapshots, such as AWS::EC2::Volume, specify Snapshot to have AWS CloudFormation create a snapshot before deleting the old resource instance. You can apply the UpdateReplacePolicy attribute to any resource. UpdateReplacePolicy is only executed if you update a resource property whose update behavior is specified as Replacement, thereby causing AWS CloudFormation to replace the old resource with a new one with a new physical ID. For example, if you update the Engine property of an AWS::RDS::DBInstance resource type, AWS CloudFormation creates a new resource and replaces the current DB instance resource with the new one. The UpdateReplacePolicy attribute would then dictate whether AWS CloudFormation deleted, retained, or created a snapshot of the old DB instance. The update behavior for each property of a resource is specified in the reference topic for that resource in the AWS Resource and Property Types Reference. For more information on resource update behavior, see Update Behaviors of Stack Resources. The UpdateReplacePolicy attribute applies to stack updates you perform directly, as well as stack updates performed using change sets. Note Resources that are retained continue to exist and continue to incur applicable charges until you delete those resources. Snapshots that are created with this policy continue to exist and continue to incur applicable charges until you delete those snapshots. UpdateReplacePolicy retains the old physical resource or snapshot, but removes it from AWS CloudFormation's scope. UpdateReplacePolicy differs from the DeletionPolicy attribute in that it only applies to resources replaced during stack updates. Use DeletionPolicy for resources deleted when a stack is deleted, or when the resource definition itself is deleted from the template as part of a stack update. You must use one of the following options: "Delete","Retain","Snapshot" .PARAMETER DependsOn With the DependsOn attribute you can specify that the creation of a specific resource follows another. When you add a DependsOn attribute to a resource, that resource is created only after the creation of the resource specified in the DependsOn attribute. This parameter takes a string or list of strings representing Logical IDs of resources that must be created prior to this resource being created. .PARAMETER Metadata The Metadata attribute enables you to associate structured data with a resource. By adding a Metadata attribute to a resource, you can add data in JSON or YAML to the resource declaration. In addition, you can use intrinsic functions (such as GetAtt and Ref), parameters, and pseudo parameters within the Metadata attribute to add those interpreted values. This will be returned when describing the resource using AWS CLI. .PARAMETER UpdatePolicy Use the UpdatePolicy attribute to specify how AWS CloudFormation handles updates to the AWS::AutoScaling::AutoScalingGroup resource. AWS CloudFormation invokes one of three update policies depending on the type of change you make or whether a scheduled action is associated with the Auto Scaling group. You must use the "Add-UpdatePolicy" function or the [UpdatePolicy] class here. .PARAMETER Condition Logical ID of the condition that this resource needs to be true in order for this resource to be provisioned. .FUNCTIONALITY Vaporshell #> [OutputType([ElasticLoadBalancingLoadBalancer])] [cmdletbinding()] Param( [parameter(Mandatory = $true,Position = 0)] [ValidateLogicalId()] [string] $LogicalId, [parameter(Mandatory = $false)] $AccessLoggingPolicy, [parameter(Mandatory = $false)] [object] $AppCookieStickinessPolicy, [parameter(Mandatory = $false)] $AvailabilityZones, [parameter(Mandatory = $false)] $ConnectionDrainingPolicy, [parameter(Mandatory = $false)] $ConnectionSettings, [parameter(Mandatory = $false)] [object] $CrossZone, [parameter(Mandatory = $false)] $HealthCheck, [parameter(Mandatory = $false)] $Instances, [parameter(Mandatory = $false)] [object] $LBCookieStickinessPolicy, [parameter(Mandatory = $true)] [object] $Listeners, [parameter(Mandatory = $false)] [object] $LoadBalancerName, [parameter(Mandatory = $false)] [object] $Policies, [parameter(Mandatory = $false)] [object] $Scheme, [parameter(Mandatory = $false)] $SecurityGroups, [parameter(Mandatory = $false)] $Subnets, [TransformTag()] [object] [parameter(Mandatory = $false)] $Tags, [parameter()] [DeletionPolicy] $DeletionPolicy, [parameter()] [UpdateReplacePolicy] $UpdateReplacePolicy, [parameter(Mandatory = $false)] [string[]] $DependsOn, [parameter(Mandatory = $false)] [VSJson] $Metadata, [parameter(Mandatory = $false)] [UpdatePolicy] $UpdatePolicy, [parameter(Mandatory = $false)] [string] $Condition ) Process { $obj = [ElasticLoadBalancingLoadBalancer]::new($PSBoundParameters) Write-Debug "$($MyInvocation.MyCommand) PSBoundParameters:`n$($PSBoundParameters | ConvertTo-Json -Depth 20 | Format-Json)" Write-Verbose "Resulting object from $($MyInvocation.MyCommand): `n$($obj.ToJson() | Format-Json)" $obj } } Export-ModuleMember -Function 'New-VSElasticLoadBalancingLoadBalancer' |