Add DNS suffixes resource (#217)

* Add DNS suffixes resource

* Add missing parameter attribtue

CHANGELOG.md

@@ -25,6 +25,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - RenameNetworkAdapters
     - Add composite to rename network adapters
     - Add documentation
+- DnsSuffixes
+  - new resource to configure connection-specific DNS suffixes
 
 ### Changed
 

source/DSCResources/DnsSuffixes/DnsSuffixes.psd1

@@ -0,0 +1,15 @@
+@{
+    RootModule           = 'DnsSuffixes.schema.psm1'
+
+    ModuleVersion        = '0.0.1'
+
+    GUID                 = '20392fe9-270d-4295-af2c-2401dd015596'
+
+    Author               = 'NA'
+
+    CompanyName          = 'NA'
+
+    Copyright            = 'NA'
+
+    DscResourcesToExport = @('DnsSuffixes')
+}

source/DSCResources/DnsSuffixes/DnsSuffixes.schema.psm1

@@ -0,0 +1,26 @@
+configuration DnsSuffixes
+{
+    param
+    (
+        [Parameter(Mandatory = $true)]
+        [hashtable[]]
+        $Suffixes
+    )
+
+    Import-DscResource -ModuleName NetworkingDsc -Name DnsConnectionSuffix
+
+    foreach ($suffix in $Suffixes)
+    {
+        # Remove Case Sensitivity of ordered Dictionary or Hashtables
+        $suffix = @{} + $suffix
+
+        if (-not $suffix.ContainsKey('Ensure'))
+        {
+            $suffix.Ensure = 'Present'
+        }
+
+        $executionName = "dnssuffix_$($suffix.InterfaceAlias)_$($suffix.ConnectionSpecificSuffix)" -replace '[()-.:\s]', '_'
+
+        (Get-DscSplattedResource -ResourceName DnsConnectionSuffix -ExecutionName $executionName -Properties $suffix -NoInvoke).Invoke($suffix)
+    }
+}

tests/Unit/DSCResources/Assets/Config/DnsSuffixes.yml

@@ -0,0 +1,3 @@
+Suffixes:
+  - InterfaceAlias: en0
+    ConnectionSpecificSuffix: contoso.com