Added support for parameter CachingMode (#29)

- Changes to xSmbShare
  - Added support for parameter CachingMode (issue #8).

Author: johlju

DscResources/MSFT_xSmbShare/MSFT_xSmbShare.psm1

@@ -53,6 +53,7 @@ function Get-TargetResource
         ConcurrentUserLimit   = $smbShare.ConcurrentUserLimit
         EncryptData           = $smbShare.EncryptData
         FolderEnumerationMode = $smbShare.FolderEnumerationMode
+        CachingMode           = $smbShare.CachingMode
         ShareState            = $smbShare.ShareState
         ShareType             = $smbShare.ShareType
         ShadowCopy            = $smbShare.ShadowCopy
@@ -192,6 +193,10 @@ function Set-TargetResource
         [System.String]
         $FolderEnumerationMode,
 
+        [ValidateSet("None","Manual","Programs","Documents","BranchCache")]
+        [System.String]
+        $CachingMode,
+
         [System.String[]]
         $FullAccess,
 
@@ -364,6 +369,10 @@ function Test-TargetResource
         [System.String]
         $FolderEnumerationMode,
 
+        [ValidateSet("None","Manual","Programs","Documents","BranchCache")]
+        [System.String]
+        $CachingMode,
+
         [System.String[]]
         $FullAccess,
 
@@ -392,7 +401,7 @@ function Test-TargetResource
         }
         elseif ($share.Ensure -eq "Present")
         {
-            $Params = 'Name', 'Path', 'Description', 'ChangeAccess', 'ConcurrentUserLimit', 'EncryptData', 'FolderEnumerationMode', 'FullAccess', 'NoAccess', 'ReadAccess', 'Ensure'
+            $Params = 'Name', 'Path', 'Description', 'ChangeAccess', 'ConcurrentUserLimit', 'EncryptData', 'FolderEnumerationMode', 'CachingMode', 'FullAccess', 'NoAccess', 'ReadAccess', 'Ensure'
 
             # Get all matching parameters from alteredBoundParameters that are in Params
             $matchingParameters = $alteredBoundParameters.Keys.Where({($_ -in $Params)})

DscResources/MSFT_xSmbShare/MSFT_xSmbShare.schema.mof

@@ -9,6 +9,7 @@ class MSFT_xSmbShare : OMI_BaseResource
     [Write, Description("Specifies the maximum number of concurrently connected users that the new SMB share may accommodate. If this parameter is set to zero (0), then the number of users is unlimited. The default value is zero (0).")] Uint32 ConcurrentUserLimit;
     [Write, Description("Indicates that the share is encrypted.")] Boolean EncryptData;
     [Write, Description("Specifies which files and folders in the new SMB share are visible to users."), ValueMap{"AccessBased","Unrestricted"}, Values{"AccessBased","Unrestricted"}] String FolderEnumerationMode;
+    [Write, Description("Specifies the caching mode of the offline files for the SMB share."), ValueMap{"None","Manual","Programs","Documents","BranchCache"}, Values{"None","Manual","Programs","Documents","BranchCache"}] String CachingMode;
     [Write, Description("Specifies which accounts are granted full permission to access the share.")] String FullAccess[];
     [Write, Description("Specifies which accounts are denied access to the share.")] String NoAccess[];
     [Write, Description("Specifies which user is granted read permission to access the share.")] String ReadAccess[];

README.md

@@ -24,6 +24,7 @@ If this parameter is set to 0, then the number of users is unlimited.
 The default value is 0.
 * **EncryptData**: Indicates that the share is encrypted.
 * **FolderEnumerationMode**: Specifies which files and folders in the new SMB share are visible to users.
+* **CachingMode**: Specifies the caching mode of the offline files for the SMB share. { 'None' | 'Manual' | 'Programs' | 'Documents' | 'BranchCache' }
 * **FullAccess**: Specifies which accounts are granted full permission to access the share.
 * **NoAccess**: Specifies which accounts are denied access to the share.
 * **ReadAccess**: Specifies which accounts are granted read permission to access the share.
@@ -42,6 +43,9 @@ Admin shares, default shares, IPC$ share are examples.
 * Update appveyor.yml to use the default template.
 * Added default template files .codecov.yml, .gitattributes, and .gitignore, and
   .vscode folder.
+* Changes to xSmbShare
+  * Added support for parameter CachingMode ([issue #8](https://github.com/PowerShell/xSmbShare/issues/8)).
+    [Martin Vokurek (@MartinVokurek)](https://github.com/MartinVokurek)
 
 ### 2.1.0.0