VaporShell.MSK.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-VSMSKClusterBrokerLogs { <# .SYNOPSIS Adds an AWS::MSK::Cluster.BrokerLogs resource property to the template. You can configure your MSK cluster to send broker logs to different destination types. This configuration specifies the details of these destinations. .DESCRIPTION Adds an AWS::MSK::Cluster.BrokerLogs resource property to the template. You can configure your MSK cluster to send broker logs to different destination types. This configuration specifies the details of these destinations. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokerlogs.html .PARAMETER S3 Details of the Amazon S3 destination for broker logs. Type: S3 Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokerlogs.html#cfn-msk-cluster-brokerlogs-s3 UpdateType: Mutable .PARAMETER Firehose Details of the Kinesis Data Firehose delivery stream that is the destination for broker logs. Type: Firehose Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokerlogs.html#cfn-msk-cluster-brokerlogs-firehose UpdateType: Mutable .PARAMETER CloudWatchLogs Details of the CloudWatch Logs destination for broker logs. Type: CloudWatchLogs Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokerlogs.html#cfn-msk-cluster-brokerlogs-cloudwatchlogs UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterBrokerLogs])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] $S3, [parameter(Mandatory = $false)] $Firehose, [parameter(Mandatory = $false)] $CloudWatchLogs ) Process { $obj = [MSKClusterBrokerLogs]::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-VSMSKClusterBrokerLogs' function Add-VSMSKClusterBrokerNodeGroupInfo { <# .SYNOPSIS Adds an AWS::MSK::Cluster.BrokerNodeGroupInfo resource property to the template. The setup to be used for brokers in the cluster. .DESCRIPTION Adds an AWS::MSK::Cluster.BrokerNodeGroupInfo resource property to the template. The setup to be used for brokers in the cluster. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html .PARAMETER SecurityGroups The AWS security groups to associate with the elastic network interfaces in order to specify who can connect to and communicate with the Amazon MSK cluster. If you don't specify a security group, Amazon MSK uses the default security group associated with the VPC. If you specify security groups that were shared with you, you must ensure that you have permissions to them. Specifically, you need the ec2:DescribeSecurityGroups permission. PrimitiveItemType: String Type: List Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html#cfn-msk-cluster-brokernodegroupinfo-securitygroups UpdateType: Immutable .PARAMETER ClientSubnets The list of subnets to connect to in the client virtual private cloud VPC. AWS creates elastic network interfaces inside these subnets. Client applications use elastic network interfaces to produce and consume data. Specify exactly two subnets if you are using one of the following Regions: South America São Paulo, Canada Central, or US West N. California. For other Regions where Amazon MSK is available, you can specify either two or three subnets. The subnets that you specify must be in distinct Availability Zones. When you create a cluster, Amazon MSK distributes the broker nodes evenly across the subnets that you specify. Client subnets can't be in Availability Zone us-east-1e. PrimitiveItemType: String Type: List Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html#cfn-msk-cluster-brokernodegroupinfo-clientsubnets UpdateType: Immutable .PARAMETER StorageInfo Contains information about storage volumes attached to MSK broker nodes. Type: StorageInfo Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html#cfn-msk-cluster-brokernodegroupinfo-storageinfo UpdateType: Immutable .PARAMETER BrokerAZDistribution The distribution of broker nodes across Availability Zones. This is an optional parameter. If you don't specify it, Amazon MSK gives it the value DEFAULT. You can also explicitly set this parameter to the value DEFAULT. No other values are currently allowed. Amazon MSK distributes the broker nodes evenly across the Availability Zones that correspond to the subnets that you provide when you create the cluster. To create a cluster, specify exactly two subnets if you are using one of the following Regions: South America São Paulo, Canada Central, or US West N. California. For other Regions where Amazon MSK is available, you can specify either two or three subnets. The subnets that you specify must be in distinct Availability Zones. Client subnets can't be in Availability Zone us-east-1e. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html#cfn-msk-cluster-brokernodegroupinfo-brokerazdistribution PrimitiveType: String UpdateType: Immutable .PARAMETER InstanceType The type of Amazon EC2 instances to use for brokers. The following instance types are allowed: kafka.m5.large, kafka.m5.xlarge, kafka.m5.2xlarge, kafka.m5.4xlarge, kafka.m5.12xlarge, and kafka.m5.24xlarge. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-brokernodegroupinfo.html#cfn-msk-cluster-brokernodegroupinfo-instancetype PrimitiveType: String UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterBrokerNodeGroupInfo])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] $SecurityGroups, [parameter(Mandatory = $true)] $ClientSubnets, [parameter(Mandatory = $false)] $StorageInfo, [parameter(Mandatory = $false)] [object] $BrokerAZDistribution, [parameter(Mandatory = $true)] [object] $InstanceType ) Process { $obj = [MSKClusterBrokerNodeGroupInfo]::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-VSMSKClusterBrokerNodeGroupInfo' function Add-VSMSKClusterClientAuthentication { <# .SYNOPSIS Adds an AWS::MSK::Cluster.ClientAuthentication resource property to the template. Includes information related to client authentication. .DESCRIPTION Adds an AWS::MSK::Cluster.ClientAuthentication resource property to the template. Includes information related to client authentication. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-clientauthentication.html .PARAMETER Sasl *Update requires*: Replacement: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement Type: Sasl Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-clientauthentication.html#cfn-msk-cluster-clientauthentication-sasl UpdateType: Mutable .PARAMETER Unauthenticated *Update requires*: Replacement: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement Type: Unauthenticated Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-clientauthentication.html#cfn-msk-cluster-clientauthentication-unauthenticated UpdateType: Mutable .PARAMETER Tls Details for client authentication using TLS. Type: Tls Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-clientauthentication.html#cfn-msk-cluster-clientauthentication-tls UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterClientAuthentication])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] $Sasl, [parameter(Mandatory = $false)] $Unauthenticated, [parameter(Mandatory = $false)] $Tls ) Process { $obj = [MSKClusterClientAuthentication]::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-VSMSKClusterClientAuthentication' function Add-VSMSKClusterCloudWatchLogs { <# .SYNOPSIS Adds an AWS::MSK::Cluster.CloudWatchLogs resource property to the template. Details of the CloudWatch Logs destination for broker logs. .DESCRIPTION Adds an AWS::MSK::Cluster.CloudWatchLogs resource property to the template. Details of the CloudWatch Logs destination for broker logs. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-cloudwatchlogs.html .PARAMETER LogGroup The CloudWatch log group that is the destination for broker logs. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-cloudwatchlogs.html#cfn-msk-cluster-cloudwatchlogs-loggroup PrimitiveType: String UpdateType: Mutable .PARAMETER Enabled Specifies whether broker logs get sent to the specified CloudWatch Logs destination. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-cloudwatchlogs.html#cfn-msk-cluster-cloudwatchlogs-enabled PrimitiveType: Boolean UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterCloudWatchLogs])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] [object] $LogGroup, [parameter(Mandatory = $true)] [object] $Enabled ) Process { $obj = [MSKClusterCloudWatchLogs]::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-VSMSKClusterCloudWatchLogs' function Add-VSMSKClusterConfigurationInfo { <# .SYNOPSIS Adds an AWS::MSK::Cluster.ConfigurationInfo resource property to the template. Specifies the Amazon MSK configuration to use for the brokers. .DESCRIPTION Adds an AWS::MSK::Cluster.ConfigurationInfo resource property to the template. Specifies the Amazon MSK configuration to use for the brokers. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-configurationinfo.html .PARAMETER Revision The revision of the Amazon MSK configuration to use. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-configurationinfo.html#cfn-msk-cluster-configurationinfo-revision PrimitiveType: Integer UpdateType: Mutable .PARAMETER Arn The Amazon Resource Name ARN of the MSK configuration to use. For example, arn:aws:kafka:us-east-1:123456789012:configuration/example-configuration-name/abcdabcd-1234-abcd-1234-abcd123e8e8e-1. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-configurationinfo.html#cfn-msk-cluster-configurationinfo-arn PrimitiveType: String UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterConfigurationInfo])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] [object] $Revision, [parameter(Mandatory = $true)] [object] $Arn ) Process { $obj = [MSKClusterConfigurationInfo]::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-VSMSKClusterConfigurationInfo' function Add-VSMSKClusterEBSStorageInfo { <# .SYNOPSIS Adds an AWS::MSK::Cluster.EBSStorageInfo resource property to the template. Contains information about the EBS storage volumes attached to brokers. .DESCRIPTION Adds an AWS::MSK::Cluster.EBSStorageInfo resource property to the template. Contains information about the EBS storage volumes attached to brokers. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-ebsstorageinfo.html .PARAMETER VolumeSize The size in GiB of the EBS volume for the data drive on each broker node. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-ebsstorageinfo.html#cfn-msk-cluster-ebsstorageinfo-volumesize PrimitiveType: Integer UpdateType: Immutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterEBSStorageInfo])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] [object] $VolumeSize ) Process { $obj = [MSKClusterEBSStorageInfo]::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-VSMSKClusterEBSStorageInfo' function Add-VSMSKClusterEncryptionAtRest { <# .SYNOPSIS Adds an AWS::MSK::Cluster.EncryptionAtRest resource property to the template. The data volume encryption details. .DESCRIPTION Adds an AWS::MSK::Cluster.EncryptionAtRest resource property to the template. The data volume encryption details. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptionatrest.html .PARAMETER DataVolumeKMSKeyId The ARN of the AWS KMS key for encrypting data at rest. If you don't specify a KMS key, MSK creates one for you and uses it on your behalf. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptionatrest.html#cfn-msk-cluster-encryptionatrest-datavolumekmskeyid PrimitiveType: String UpdateType: Immutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterEncryptionAtRest])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] [object] $DataVolumeKMSKeyId ) Process { $obj = [MSKClusterEncryptionAtRest]::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-VSMSKClusterEncryptionAtRest' function Add-VSMSKClusterEncryptionInfo { <# .SYNOPSIS Adds an AWS::MSK::Cluster.EncryptionInfo resource property to the template. Includes encryption-related information, such as the AWS KMS key used for encrypting data at rest and whether you want MSK to encrypt your data in transit. .DESCRIPTION Adds an AWS::MSK::Cluster.EncryptionInfo resource property to the template. Includes encryption-related information, such as the AWS KMS key used for encrypting data at rest and whether you want MSK to encrypt your data in transit. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptioninfo.html .PARAMETER EncryptionAtRest The data-volume encryption details. Type: EncryptionAtRest Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptioninfo.html#cfn-msk-cluster-encryptioninfo-encryptionatrest UpdateType: Immutable .PARAMETER EncryptionInTransit The details for encryption in transit. Type: EncryptionInTransit Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptioninfo.html#cfn-msk-cluster-encryptioninfo-encryptionintransit UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterEncryptionInfo])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] $EncryptionAtRest, [parameter(Mandatory = $false)] $EncryptionInTransit ) Process { $obj = [MSKClusterEncryptionInfo]::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-VSMSKClusterEncryptionInfo' function Add-VSMSKClusterEncryptionInTransit { <# .SYNOPSIS Adds an AWS::MSK::Cluster.EncryptionInTransit resource property to the template. The settings for encrypting data in transit. .DESCRIPTION Adds an AWS::MSK::Cluster.EncryptionInTransit resource property to the template. The settings for encrypting data in transit. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptionintransit.html .PARAMETER ClientBroker Indicates the encryption setting for data in transit between clients and brokers. The following are the possible values. + TLS means that client-broker communication is enabled with TLS only. + TLS_PLAINTEXT means that client-broker communication is enabled for both TLS-encrypted, as well as plaintext data. + PLAINTEXT means that client-broker communication is enabled in plaintext only. The default value is TLS_PLAINTEXT. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptionintransit.html#cfn-msk-cluster-encryptionintransit-clientbroker PrimitiveType: String UpdateType: Mutable .PARAMETER InCluster When set to true, it indicates that data communication among the broker nodes of the cluster is encrypted. When set to false, the communication happens in plaintext. The default value is true. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-encryptionintransit.html#cfn-msk-cluster-encryptionintransit-incluster PrimitiveType: Boolean UpdateType: Immutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterEncryptionInTransit])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] [object] $ClientBroker, [parameter(Mandatory = $false)] [object] $InCluster ) Process { $obj = [MSKClusterEncryptionInTransit]::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-VSMSKClusterEncryptionInTransit' function Add-VSMSKClusterFirehose { <# .SYNOPSIS Adds an AWS::MSK::Cluster.Firehose resource property to the template. Details of the Kinesis Data Firehose delivery stream that is the destination for broker logs. .DESCRIPTION Adds an AWS::MSK::Cluster.Firehose resource property to the template. Details of the Kinesis Data Firehose delivery stream that is the destination for broker logs. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-firehose.html .PARAMETER DeliveryStream The Kinesis Data Firehose delivery stream that is the destination for broker logs. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-firehose.html#cfn-msk-cluster-firehose-deliverystream PrimitiveType: String UpdateType: Mutable .PARAMETER Enabled Specifies whether broker logs get sent to the specified Kinesis Data Firehose delivery stream. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-firehose.html#cfn-msk-cluster-firehose-enabled PrimitiveType: Boolean UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterFirehose])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] [object] $DeliveryStream, [parameter(Mandatory = $true)] [object] $Enabled ) Process { $obj = [MSKClusterFirehose]::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-VSMSKClusterFirehose' function Add-VSMSKClusterIam { <# .SYNOPSIS Adds an AWS::MSK::Cluster.Iam resource property to the template. .DESCRIPTION Adds an AWS::MSK::Cluster.Iam resource property to the template. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-iam.html .PARAMETER Enabled Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-iam.html#cfn-msk-cluster-iam-enabled PrimitiveType: Boolean UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterIam])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] [object] $Enabled ) Process { $obj = [MSKClusterIam]::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-VSMSKClusterIam' function Add-VSMSKClusterJmxExporter { <# .SYNOPSIS Adds an AWS::MSK::Cluster.JmxExporter resource property to the template. Indicates whether you want to enable or disable the JMX Exporter. .DESCRIPTION Adds an AWS::MSK::Cluster.JmxExporter resource property to the template. Indicates whether you want to enable or disable the JMX Exporter. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-jmxexporter.html .PARAMETER EnabledInBroker Indicates whether you want to enable or disable the JMX Exporter. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-jmxexporter.html#cfn-msk-cluster-jmxexporter-enabledinbroker PrimitiveType: Boolean UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterJmxExporter])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] [object] $EnabledInBroker ) Process { $obj = [MSKClusterJmxExporter]::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-VSMSKClusterJmxExporter' function Add-VSMSKClusterLoggingInfo { <# .SYNOPSIS Adds an AWS::MSK::Cluster.LoggingInfo resource property to the template. You can configure your MSK cluster to send broker logs to different destination types. This is a container for the configuration details related to broker logs. .DESCRIPTION Adds an AWS::MSK::Cluster.LoggingInfo resource property to the template. You can configure your MSK cluster to send broker logs to different destination types. This is a container for the configuration details related to broker logs. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-logginginfo.html .PARAMETER BrokerLogs You can configure your MSK cluster to send broker logs to different destination types. This configuration specifies the details of these destinations. Type: BrokerLogs Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-logginginfo.html#cfn-msk-cluster-logginginfo-brokerlogs UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterLoggingInfo])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] $BrokerLogs ) Process { $obj = [MSKClusterLoggingInfo]::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-VSMSKClusterLoggingInfo' function Add-VSMSKClusterNodeExporter { <# .SYNOPSIS Adds an AWS::MSK::Cluster.NodeExporter resource property to the template. Indicates whether you want to enable or disable the Node Exporter. .DESCRIPTION Adds an AWS::MSK::Cluster.NodeExporter resource property to the template. Indicates whether you want to enable or disable the Node Exporter. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-nodeexporter.html .PARAMETER EnabledInBroker Indicates whether you want to enable or disable the Node Exporter. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-nodeexporter.html#cfn-msk-cluster-nodeexporter-enabledinbroker PrimitiveType: Boolean UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterNodeExporter])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] [object] $EnabledInBroker ) Process { $obj = [MSKClusterNodeExporter]::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-VSMSKClusterNodeExporter' function Add-VSMSKClusterOpenMonitoring { <# .SYNOPSIS Adds an AWS::MSK::Cluster.OpenMonitoring resource property to the template. JMX and Node monitoring for the MSK cluster. .DESCRIPTION Adds an AWS::MSK::Cluster.OpenMonitoring resource property to the template. JMX and Node monitoring for the MSK cluster. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-openmonitoring.html .PARAMETER Prometheus Prometheus exporter settings. Type: Prometheus Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-openmonitoring.html#cfn-msk-cluster-openmonitoring-prometheus UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterOpenMonitoring])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] $Prometheus ) Process { $obj = [MSKClusterOpenMonitoring]::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-VSMSKClusterOpenMonitoring' function Add-VSMSKClusterPrometheus { <# .SYNOPSIS Adds an AWS::MSK::Cluster.Prometheus resource property to the template. Prometheus settings for open monitoring. .DESCRIPTION Adds an AWS::MSK::Cluster.Prometheus resource property to the template. Prometheus settings for open monitoring. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-prometheus.html .PARAMETER JmxExporter Indicates whether you want to enable or disable the JMX Exporter. Type: JmxExporter Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-prometheus.html#cfn-msk-cluster-prometheus-jmxexporter UpdateType: Mutable .PARAMETER NodeExporter Indicates whether you want to enable or disable the Node Exporter. Type: NodeExporter Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-prometheus.html#cfn-msk-cluster-prometheus-nodeexporter UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterPrometheus])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] $JmxExporter, [parameter(Mandatory = $false)] $NodeExporter ) Process { $obj = [MSKClusterPrometheus]::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-VSMSKClusterPrometheus' function Add-VSMSKClusterS3 { <# .SYNOPSIS Adds an AWS::MSK::Cluster.S3 resource property to the template. The details of the Amazon S3 destination for broker logs. .DESCRIPTION Adds an AWS::MSK::Cluster.S3 resource property to the template. The details of the Amazon S3 destination for broker logs. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-s3.html .PARAMETER Bucket The name of the S3 bucket that is the destination for broker logs. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-s3.html#cfn-msk-cluster-s3-bucket PrimitiveType: String UpdateType: Mutable .PARAMETER Enabled Specifies whether broker logs get sent to the specified Amazon S3 destination. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-s3.html#cfn-msk-cluster-s3-enabled PrimitiveType: Boolean UpdateType: Mutable .PARAMETER Prefix The S3 prefix that is the destination for broker logs. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-s3.html#cfn-msk-cluster-s3-prefix PrimitiveType: String UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterS3])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] [object] $Bucket, [parameter(Mandatory = $true)] [object] $Enabled, [parameter(Mandatory = $false)] [object] $Prefix ) Process { $obj = [MSKClusterS3]::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-VSMSKClusterS3' function Add-VSMSKClusterSasl { <# .SYNOPSIS Adds an AWS::MSK::Cluster.Sasl resource property to the template. .DESCRIPTION Adds an AWS::MSK::Cluster.Sasl resource property to the template. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-sasl.html .PARAMETER Iam Type: Iam Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-sasl.html#cfn-msk-cluster-sasl-iam UpdateType: Mutable .PARAMETER Scram Type: Scram Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-sasl.html#cfn-msk-cluster-sasl-scram UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterSasl])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] $Iam, [parameter(Mandatory = $false)] $Scram ) Process { $obj = [MSKClusterSasl]::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-VSMSKClusterSasl' function Add-VSMSKClusterScram { <# .SYNOPSIS Adds an AWS::MSK::Cluster.Scram resource property to the template. .DESCRIPTION Adds an AWS::MSK::Cluster.Scram resource property to the template. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-scram.html .PARAMETER Enabled Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-scram.html#cfn-msk-cluster-scram-enabled PrimitiveType: Boolean UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterScram])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] [object] $Enabled ) Process { $obj = [MSKClusterScram]::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-VSMSKClusterScram' function Add-VSMSKClusterStorageInfo { <# .SYNOPSIS Adds an AWS::MSK::Cluster.StorageInfo resource property to the template. Contains information about storage volumes attached to MSK broker nodes. .DESCRIPTION Adds an AWS::MSK::Cluster.StorageInfo resource property to the template. Contains information about storage volumes attached to MSK broker nodes. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-storageinfo.html .PARAMETER EBSStorageInfo EBS volume information. Type: EBSStorageInfo Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-storageinfo.html#cfn-msk-cluster-storageinfo-ebsstorageinfo UpdateType: Immutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterStorageInfo])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] $EBSStorageInfo ) Process { $obj = [MSKClusterStorageInfo]::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-VSMSKClusterStorageInfo' function Add-VSMSKClusterTls { <# .SYNOPSIS Adds an AWS::MSK::Cluster.Tls resource property to the template. Details for client authentication using TLS. .DESCRIPTION Adds an AWS::MSK::Cluster.Tls resource property to the template. Details for client authentication using TLS. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-tls.html .PARAMETER Enabled *Update requires*: Replacement: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-tls.html#cfn-msk-cluster-tls-enabled PrimitiveType: Boolean UpdateType: Mutable .PARAMETER CertificateAuthorityArnList List of ACM Certificate Authority ARNs. PrimitiveItemType: String Type: List Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-tls.html#cfn-msk-cluster-tls-certificateauthorityarnlist UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterTls])] [cmdletbinding()] Param( [parameter(Mandatory = $false)] [object] $Enabled, [parameter(Mandatory = $false)] $CertificateAuthorityArnList ) Process { $obj = [MSKClusterTls]::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-VSMSKClusterTls' function Add-VSMSKClusterUnauthenticated { <# .SYNOPSIS Adds an AWS::MSK::Cluster.Unauthenticated resource property to the template. .DESCRIPTION Adds an AWS::MSK::Cluster.Unauthenticated resource property to the template. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-unauthenticated.html .PARAMETER Enabled Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-msk-cluster-unauthenticated.html#cfn-msk-cluster-unauthenticated-enabled PrimitiveType: Boolean UpdateType: Mutable .FUNCTIONALITY Vaporshell #> [OutputType([MSKClusterUnauthenticated])] [cmdletbinding()] Param( [parameter(Mandatory = $true)] [object] $Enabled ) Process { $obj = [MSKClusterUnauthenticated]::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-VSMSKClusterUnauthenticated' function New-VSMSKCluster { <# .SYNOPSIS Adds an AWS::MSK::Cluster resource to the template. The AWS::MSK::Cluster resource creates an Amazon MSK cluster. For more information, see What Is Amazon MSK?: https://docs.aws.amazon.com/msk/latest/developerguide/what-is-msk.html in the *Amazon MSK Developer Guide*. .DESCRIPTION Adds an AWS::MSK::Cluster resource to the template. The AWS::MSK::Cluster resource creates an Amazon MSK cluster. For more information, see What Is Amazon MSK?: https://docs.aws.amazon.com/msk/latest/developerguide/what-is-msk.html in the *Amazon MSK Developer Guide*. .LINK http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.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 BrokerNodeGroupInfo The setup to be used for brokers in the cluster. Type: BrokerNodeGroupInfo Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-brokernodegroupinfo UpdateType: Mutable .PARAMETER EnhancedMonitoring Specifies the level of monitoring for the MSK cluster. The possible values are DEFAULT, PER_BROKER, and PER_TOPIC_PER_BROKER. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-enhancedmonitoring PrimitiveType: String UpdateType: Mutable .PARAMETER KafkaVersion The version of Apache Kafka. You can use Amazon MSK to create clusters that use Apache Kafka versions 1.1.1 and 2.2.1. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-kafkaversion PrimitiveType: String UpdateType: Mutable .PARAMETER NumberOfBrokerNodes The number of broker nodes you want in the Amazon MSK cluster. You can submit an update to increase the number of broker nodes in a cluster. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-numberofbrokernodes PrimitiveType: Integer UpdateType: Mutable .PARAMETER EncryptionInfo Includes all encryption-related information. Type: EncryptionInfo Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-encryptioninfo UpdateType: Mutable .PARAMETER OpenMonitoring The settings for open monitoring. Type: OpenMonitoring Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-openmonitoring UpdateType: Mutable .PARAMETER ClusterName The name of the cluster. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-clustername PrimitiveType: String UpdateType: Immutable .PARAMETER ClientAuthentication Includes information related to client authentication. Type: ClientAuthentication Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-clientauthentication UpdateType: Mutable .PARAMETER LoggingInfo You can configure your MSK cluster to send broker logs to different destination types. This is a container for the configuration details related to broker logs. Type: LoggingInfo Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-logginginfo UpdateType: Mutable .PARAMETER Tags A map of key:value pairs to apply to this resource. Both key and value are of type String. Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-tags PrimitiveType: Json UpdateType: Immutable .PARAMETER ConfigurationInfo The Amazon MSK configuration to use for the cluster. Type: ConfigurationInfo Documentation: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-msk-cluster.html#cfn-msk-cluster-configurationinfo 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([MSKCluster])] [cmdletbinding()] Param( [parameter(Mandatory = $true,Position = 0)] [ValidateLogicalId()] [string] $LogicalId, [parameter(Mandatory = $true)] $BrokerNodeGroupInfo, [parameter(Mandatory = $false)] [object] $EnhancedMonitoring, [parameter(Mandatory = $true)] [object] $KafkaVersion, [parameter(Mandatory = $true)] [object] $NumberOfBrokerNodes, [parameter(Mandatory = $false)] $EncryptionInfo, [parameter(Mandatory = $false)] $OpenMonitoring, [parameter(Mandatory = $true)] [object] $ClusterName, [parameter(Mandatory = $false)] $ClientAuthentication, [parameter(Mandatory = $false)] $LoggingInfo, [parameter(Mandatory = $false)] [VSJson] $Tags, [parameter(Mandatory = $false)] $ConfigurationInfo, [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 = [MSKCluster]::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-VSMSKCluster' |