Add validation for CatalogCollation parameter and error message for unsupported SQL Server versions

Author: johlju

source/Public/New-SqlDscDatabase.ps1

@@ -187,6 +187,24 @@ function New-SqlDscDatabase
             }
         }
 
+        # Validate CatalogCollation if specified (requires SQL Server 2019+)
+        if ($PSBoundParameters.ContainsKey('CatalogCollation'))
+        {
+            if ($ServerObject.VersionMajor -lt 15)
+            {
+                $errorMessage = $script:localizedData.Database_CatalogCollationNotSupported -f $ServerObject.InstanceName, $ServerObject.VersionMajor
+
+                $PSCmdlet.ThrowTerminatingError(
+                    [System.Management.Automation.ErrorRecord]::new(
+                        [System.InvalidOperationException]::new($errorMessage),
+                        'NSD0005', # cspell: disable-line
+                        [System.Management.Automation.ErrorCategory]::InvalidOperation,
+                        $CatalogCollation
+                    )
+                )
+            }
+        }
+
         $verboseDescriptionMessage = $script:localizedData.Database_Create_ShouldProcessVerboseDescription -f $Name, $ServerObject.InstanceName
         $verboseWarningMessage = $script:localizedData.Database_Create_ShouldProcessVerboseWarning -f $Name
         $captionMessage = $script:localizedData.Database_Create_ShouldProcessCaption

source/en-US/SqlServerDsc.strings.psd1

@@ -357,6 +357,7 @@ ConvertFrom-StringData @'
     Database_AlreadyExists = Database '{0}' already exists on instance '{1}'.
     Database_InvalidCompatibilityLevel = The specified compatibility level '{0}' is not a valid compatibility level for the instance '{1}'.
     Database_InvalidCollation = The specified collation '{0}' is not a valid collation for the instance '{1}'.
+    Database_CatalogCollationNotSupported = The parameter CatalogCollation is not supported on SQL Server instance '{0}' with version '{1}'. This parameter requires SQL Server 2019 (version 15) or later.
     Database_Create_ShouldProcessVerboseDescription = Creating the database '{0}' on the instance '{1}'.
     Database_Create_ShouldProcessVerboseWarning = Are you sure you want to create the database '{0}'?
     # This string shall not end with full stop (.) since it is used as a title of ShouldProcess messages.