Updated pipeline to latest Sampler version (#197)

* Aligned pipeline configuration with `ComputerManagementDsc`

* Updates to latest Sampler version

* Switched build to Windows PowerShell

* Cleanup

* Added task `FixEncoding`

* Fixed `build.yml` and added section for 'DscResource.DocGenerator'

* Removed `Write-Host` as per PSScriptAnalyzer recommendation

* Removed `PSAvoidUsingWriteHost`

Author: raandree

.build/FixEncoding.ps1

@@ -0,0 +1,28 @@
+<#
+    .SYNOPSIS
+        Sets the encoding of all *.psd1 files to UTF8.
+
+    .DESCRIPTION
+        Sets the encoding of all *.psd1 files to UTF8. This is a build task that is
+
+        This task is only needed when the build runs on Windows PowerShell 5.1.
+
+    .NOTES
+        This is a build task that is primarily meant to be run by Invoke-Build but
+        wrapped by the Sampler project's build.ps1 (https://github.com/gaelcolas/Sampler).
+#>
+
+param ()
+
+task FixEncoding {
+
+    Write-Build Yellow "Setting encoding to UTF8 for *.PSD1 files in path '$BuildModuleOutput'."
+    $utf8NoBomEncoding = New-Object System.Text.UTF8Encoding($false)
+
+    Get-ChildItem -Path $BuildModuleOutput -Filter *.psd1 -Recurse -File | ForEach-Object {
+
+        Write-Build DarkGray "`t'$($_.FullName)'."
+        $c = [System.IO.File]::ReadAllLines($_.FullName)
+        [System.IO.File]::WriteAllLines($_.FullName, $c, $utf8NoBomEncoding)
+    }
+}

.build/test.ps1

@@ -99,4 +99,7 @@ set to true when the LCM is already in ApplyAndAutoCorrect mode.
   - xHyper-V
   - VSTSAgent
 - Refactoring of SqlPermissions after upgrade of SqlServerDsc to 16.0.0
-- WindowsFeatures: Include support for more elaborate lists of features, giving more control
+- WindowsFeatures: Include support for more elaborate lists of features, giving
+  more control.
+- Added task `FixEncoding` for being able to run the build on Windows PowerShell
+  due to an encoding issue with the psd1 file.