Added AllowAppend parameter

Author: jcwalker

DSCResources/DSR_ReplaceText/DSR_ReplaceText.psm1

@@ -133,7 +133,11 @@ function Set-TargetResource
         [Parameter()]
         [System.Management.Automation.PSCredential]
         [System.Management.Automation.Credential()]
-        $Secret
+        $Secret,
+
+        [Parameter()]
+        [System.Boolean]
+        $AllowAppend = $false
     )
 
     Assert-ParametersValid @PSBoundParameters
@@ -158,7 +162,7 @@ function Set-TargetResource
         # Configuration file does not exist
         $fileContent = $Text
     }
-    elseif ( [regex]::Matches($fileContent, $Search).Count -eq 0 )
+    elseif ([regex]::Matches($fileContent, $Search).Count -eq 0 -and $AllowAppend -eq $true)
     {
         # Configuration file exists but Text does not exist so lets add it
         $fileContent = Add-ConfigurationEntry -FileContent $fileContent -Text $Text
@@ -225,7 +229,11 @@ function Test-TargetResource
         [Parameter()]
         [System.Management.Automation.PSCredential]
         [System.Management.Automation.Credential()]
-        $Secret
+        $Secret,
+
+        [Parameter()]
+        [System.Boolean]
+        $AllowAppend = $false
     )
 
     Assert-ParametersValid @PSBoundParameters
@@ -246,11 +254,20 @@ function Test-TargetResource
 
     if ($results.Count -eq 0)
     {
+        if ($AllowAppend -eq $true)
+        {
+            # No matches found - but we want to append
+            Write-Verbose -Message ($localizedData.StringNotFoundMessageAppend -f `
+                    $Path, $Search)
+
+            return $false
+        }
+
         # No matches found - already in state
         Write-Verbose -Message ($localizedData.StringNotFoundMessage -f `
                 $Path, $Search)
 
-        return $false
+        return $true
     }
 
     # Flag to signal whether settings are correct
@@ -332,7 +349,11 @@ function Assert-ParametersValid
         [Parameter()]
         [System.Management.Automation.PSCredential]
         [System.Management.Automation.Credential()]
-        $Secret
+        $Secret,
+
+        [Parameter()]
+        [System.Boolean]
+        $AllowAppend = $false
     )
 
     # Does the file's parent path exist?
@@ -361,11 +382,11 @@ function Add-ConfigurationEntry
     [CmdletBinding()]
     param
     (
-        [Parameter()]
+        [Parameter(Mandatory = $true)]
         [String]
         $FileContent,
 
-        [Parameter()]
+        [Parameter(Mandatory = $true)]
         [String]
         $Text
     )
@@ -376,7 +397,8 @@ function Add-ConfigurationEntry
 
     foreach ($line in $fileContentArray)
     {
-        $null = $stringBuilder.AppendLine($line)
+        # Lets remove the return character since AppendLine() always adds one
+        $null = $stringBuilder.AppendLine($line -replace '\r')
     }
 
     $null = $stringBuilder.AppendLine($Text)

DSCResources/DSR_ReplaceText/DSR_ReplaceText.schema.mof

@@ -5,5 +5,6 @@ class DSR_ReplaceText : OMI_BaseResource
   [Key, Description("The RegEx string to use to search the text file.")] String Search;
   [Write, Description("Specifies the value type to use as the replacement string. Defaults to 'Text'."),ValueMap{"Text", "Secret"},Values{"Text", "Secret"}] String Type;
   [Write, Description("The text to replace the text identified by the RegEx. Only used when Type is set to 'Text'.")] String Text;
-  [write, Description("The secret text to replace the text identified by the RegEx. Only used when Type is set to 'Secret'."),EmbeddedInstance("MSFT_Credential")] String Secret;
+  [Write, Description("The secret text to replace the text identified by the RegEx. Only used when Type is set to 'Secret'."),EmbeddedInstance("MSFT_Credential")] String Secret;
+  [Write, Description("Specifies to append text to the file being modified. Adds the ability to add a configuration entry")] Boolean AllowAppend;
 };

DSCResources/DSR_ReplaceText/en-US/DSR_ReplaceText.strings.psd1

@@ -2,7 +2,8 @@
 
 ConvertFrom-StringData @'
     SearchForTextMessage = Searching using RegEx '{1}' in file '{0}'.
-    StringNotFoundMessage = String not found using RegEx '{1}' in file '{0}', change required.
+    StringNotFoundMessageAppend = String not found using RegEx '{1}' in file '{0}', change required.
+    StringNotFoundMessage = String not found using RegEx '{1}' in file '{0}', change not required.
     StringMatchFoundMessage = String(s) '{2}' found using RegEx '{1}' in file '{0}'.
     StringReplacementRequiredMessage = String found using RegEx '{1}' in file '{0}', replacement required.
     StringNoReplacementMessage = String found using RegEx '{1}' in file '{0}', no replacement required.