New Resource WSManClientConfig

CHANGELOG.md

@@ -15,6 +15,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Added `DscResource.Base` class.
 - `WSManConfigBase`
   - Base class for WSMan*Config Resources fixes [#44](https://github.com/dsccommunity/WSManDsc/issues/44).
+- `WSManClientConfig` resource. Fixes [#41](https://github.com/dsccommunity/WSManDsc/issues/41).
 
 ### Changed
 

Resolve-Dependency.psd1

@@ -3,7 +3,7 @@
     AllowPrerelease = $false
     WithYAML        = $true
 
-    #UseModuleFast = $true
+    UseModuleFast = $true
     #ModuleFastVersion = '0.1.2'
     #ModuleFastBleedingEdge = $true
 

source/Classes/010.WSManConfigBase.ps1

@@ -70,6 +70,12 @@ class WSManConfigBase : ResourceBase
                 continue
             }
 
+            if ($targetType -eq [System.String[]])
+            {
+                $state[$property.Name] = $property.Value -split ','
+                continue
+            }
+
             $state[$property.Name] = [System.Management.Automation.LanguagePrimitives]::ConvertTo(
                 $property.Value,
                 $targetType
@@ -89,14 +95,19 @@ class WSManConfigBase : ResourceBase
 
         foreach ($property in $properties.GetEnumerator())
         {
+            $uri = $baseUri
             if ($property.Name.StartsWith('Auth'))
             {
                 $property.Name = $property.Name -replace '^Auth', ''
-                Set-Item -Path ('{0}\Auth\{1}' -f $baseUri, $property.Name) -Value $property.Value -Force
-                continue
+                $uri = ('{0}\Auth' -f $baseUri)
+            }
+
+            if ($property.Value -is [System.String[]])
+            {
+                $property.Value = $property.Value -join ','
             }
 
-            Set-Item -Path ('{0}\{1}' -f $baseUri, $property.Name) -Value $property.Value -Force
+            Set-Item -Path ('{0}\{1}' -f $uri, $property.Name) -Value $property.Value -Force
         }
     }
 

source/Classes/020.WSManClientConfig.ps1

@@ -0,0 +1,131 @@
+<#
+    .SYNOPSIS
+        The `WSManClientConfig` DSC resource is used to configure WS-Man client specific settings.
+
+    .DESCRIPTION
+        This resource is used configure WS-Man Client settings.
+
+    .PARAMETER NetworkDelayms
+        Specifies the extra time in milliseconds that the client computer waits to accommodate for network delay time.
+
+    .PARAMETER URLPrefix
+        Specifies a URL prefix on which to accept HTTP or HTTPS requests. The default URL prefix is wsman.
+
+    .PARAMETER AllowUnencrypted
+        Allows the client computer to request unencrypted traffic.
+
+    .PARAMETER TrustedHosts
+        Specifies the list of remote computers that are trusted.
+
+    .PARAMETER AuthBasic
+        Allows the WinRM client to use Basic authentication.
+
+    .PARAMETER AuthDigest
+        Allows the WinRM client to use Digest authentication.
+
+    .PARAMETER AuthCertificate
+        Allows the WinRM client to use client certificate-based authentication.
+
+    .PARAMETER AuthKerberos
+        Allows the WinRM client to use Kerberos authentication.
+
+    .PARAMETER AuthNegotiate
+        Allows the WinRM client to use Negotiate authentication.
+
+    .PARAMETER AuthCredSSP
+        Allows the WinRM client to use Credential Security Support Provider (CredSSP) authentication.
+#>
+
+[DscResource()]
+class WSManClientConfig : WSManConfigBase
+{
+    [DscProperty()]
+    [Nullable[System.UInt32]]
+    $NetworkDelayms
+
+    [DscProperty()]
+    [System.String]
+    $URLPrefix
+
+    [DscProperty()]
+    [Nullable[System.Boolean]]
+    $AllowUnencrypted
+
+    [DscProperty()]
+    [System.String[]]
+    $TrustedHosts
+
+    [DscProperty()]
+    [Nullable[System.Boolean]]
+    $AuthBasic
+
+    [DscProperty()]
+    [Nullable[System.Boolean]]
+    $AuthDigest
+
+    [DscProperty()]
+    [Nullable[System.Boolean]]
+    $AuthCertificate
+
+    [DscProperty()]
+    [Nullable[System.Boolean]]
+    $AuthKerberos
+
+    [DscProperty()]
+    [Nullable[System.Boolean]]
+    $AuthNegotiate
+
+    [DscProperty()]
+    [Nullable[System.Boolean]]
+    $AuthCredSSP
+
+    WSManClientConfig () : base ()
+    {
+        $this.ResourceURI = 'localhost\Client'
+        $this.HasAuthContainer = $true
+    }
+
+    [WSManClientConfig] Get()
+    {
+        # Call the base method to return the properties.
+        return ([ResourceBase] $this).Get()
+    }
+
+    [void] Set()
+    {
+        # Call the base method to enforce the properties.
+        ([ResourceBase] $this).Set()
+    }
+
+    [System.Boolean] Test()
+    {
+        # Call the base method to test all of the properties that should be enforced.
+        return ([ResourceBase] $this).Test()
+    }
+
+    <#
+        Base method Assert() call this method with the properties that was assigned
+        a value.
+    #>
+    hidden [void] AssertProperties([System.Collections.Hashtable] $properties)
+    {
+        $assertBoundParameterParameters = @{
+            BoundParameterList = $properties
+            RequiredParameter  = @(
+                'NetworkDelayms'
+                'URLPrefix'
+                'AllowUnencrypted'
+                'TrustedHosts'
+                'AuthBasic'
+                'AuthDigest'
+                'AuthCertificate'
+                'AuthKerberos'
+                'AuthNegotiate'
+                'AuthCredSSP'
+            )
+            RequiredBehavior   = 'Any'
+        }
+
+        Assert-BoundParameter @assertBoundParameterParameters
+    }
+}

source/Examples/Resources/WSManClientConfig/1-WSManClientConfig_Config.ps1

@@ -0,0 +1,40 @@
+<#PSScriptInfo
+.VERSION 1.0.0
+.GUID 5eb95759-9a02-4121-bfca-bba124bfc4f8
+.AUTHOR DSC Community
+.COMPANYNAME DSC Community
+.COPYRIGHT Copyright the DSC Community contributors. All rights reserved.
+.TAGS DSCConfiguration
+.LICENSEURI https://github.com/dsccommunity/WSManDsc/blob/main/LICENSE
+.PROJECTURI https://github.com/dsccommunity/WSManDsc
+.ICONURI
+.EXTERNALMODULEDEPENDENCIES
+.REQUIREDSCRIPTS
+.EXTERNALSCRIPTDEPENDENCIES
+.RELEASENOTES First version.
+.PRIVATEDATA 2016-Datacenter,2016-Datacenter-Server-Core
+#>
+
+#Requires -module WSManDsc
+
+<#
+    .DESCRIPTION
+        Set the WS-Man client to disallow unencrypted traffic,
+        disable Basic authentication and set TrustedHosts to '*'.
+#>
+Configuration WSManClientConfig_Config
+{
+    Import-DscResource -Module WSManDsc
+
+    Node localhost
+    {
+        WSManClientConfig ClientConfig
+        {
+            IsSingleInstance = 'Yes'
+            AllowUnencrypted = $false
+            AuthBasic        = $false
+            TrustedHosts     = '*'
+
+        } # End of WSManClientConfig Resource
+    } # End of Node
+} # End of Configuration

source/en-US/WSManClientConfig.strings.psd1

@@ -0,0 +1,14 @@
+<#
+    .SYNOPSIS
+        The localized resource strings in English (en-US) for the
+        resource WSManClientConfig. This file should only contain
+        localized strings for private functions, public command, and
+        classes (that are not a DSC resource).
+#>
+
+ConvertFrom-StringData @'
+    ## Strings overrides for the ResourceBase's default strings.
+    # None
+
+    ## Strings directly used by the derived class WSManClientConfig.
+'@

source/en-US/WSManConfig.strings.psd1

@@ -1,7 +1,7 @@
 <#
     .SYNOPSIS
         The localized resource strings in English (en-US) for the
-        resource WSManConfig module. This file should only contain
+        resource WSManConfig. This file should only contain
         localized strings for private functions, public command, and
         classes (that are not a DSC resource).
 #>

source/en-US/WSManListener.strings.psd1

@@ -1,7 +1,7 @@
 <#
     .SYNOPSIS
         The localized resource strings in English (en-US) for the
-        resource WSManListener module. This file should only contain
+        resource WSManListener. This file should only contain
         localized strings for private functions, public command, and
         classes (that are not a DSC resource).
 #>

source/en-US/WSManServiceConfig.strings.psd1

@@ -1,7 +1,7 @@
 <#
     .SYNOPSIS
         The localized resource strings in English (en-US) for the
-        resource WSManServiceConfig module. This file should only contain
+        resource WSManServiceConfig. This file should only contain
         localized strings for private functions, public command, and
         classes (that are not a DSC resource).
 #>