I am using PowerShell version 5.0.10018.0 for the examples. This version of PowerShell ships with the WMF February 2015 Preview package that you can download here.
I was asked if there are any resources on testing class based DSC resources. And to be honest I am not sure. We shortly discussed the possibilities on the PS MVP mailing list, but I am still not sure what are the possibilities. So why not discover them while learning something more about the topic.
Luckily there are quite a few great resources on how to actually create a class based DSC resource, and what you need to do that. Some of them are:
Creating a Class based DSC Resource using PowerShell
Class-defined DSC resources in Windows Management Framework 5.0 Preview
Writing a custom DSC resource with PowerShell classes
I will be using the example code from the last article to go outside-in with Pester, and to pretend that I am actually writing the code myself.
At the bottom of the Microsoft article you find an example of how the finished resource is used. This example is an ideal candidate for our first integration test. This integration test will describe the basic functionality of the resource
The test looks like this:
I had to slightly change the code shown in the article, but that’s expected because we are using preview version of the technology. The test has three parts: Arrange, Act and Assert.
In the Arrange part I most importantly define the DSC configuration using the
FileResource resource. The configuration defines that: “I desire the file TestDrive:\test.txt to be present”.
The configuration also defines the
SourcePath, which is where the original file is placed. For the test I just use the TestDrive to store the file.
I also create all the needed files and folders in the Arrange part of the test.
In the Act phase I start by generating the configuration MOF file by calling it by it’s name:
Test. And then continue to exercise the system-under-test (SUT) by actually invoking the DSC configuration.
In the last part, Assert, I check if the desired action was really performed. That is, if the file
test.txt is in the root of the
This should do for our first test. So let’s run it and see if it fails.
If you re-call the RED-GREEN-REFACTOR cycle of TDD, you know that now we should let the test run, and make sure it fails (RED). So let’s press F5 to do just that.
And indeed the test fails horribly.
If you now assume that we saw the test fail and we can proceed to implement the correct behavior, you should know that this is not the case. The test failed, but it did not fail in the correct way. It must fail in the assertion to count as a proper fail.
To get to the point where the test fails correctly we can just follow the error messages, and oh boy there are many. The first few error messages suggested that there is no
FileResource available in the module directory. There were also few Access Denied error messages. And the
TestDrive:\ also could not be found, because the configuration is done by a Windows service running as the SYSTEM account. I also had problems with remoting not being setup correctly.
So in the end I ended doing this:
C:\Program Files\WindowsPowerShell\Modules\MyDscResource(file contents are listed below)
- Setting my public network to private network
- Enabling PowerShell remoting by running Enable-PSRemoting -Force
- Running the tests AsAdministrator
- Using $TestDrive (real path to the temporary folder) instead of the TestDrive PSDrive
So the test ended up looking like this:
And the resource is implemented like this:
So now that we have all the infrastructure setup satisfying the test is really simple. All you need to do is to create the
$testDrive\test.txt file. So let’s change the
Set() method to do that.
Running the test now should, satisfy the assert condition. But depending on how fast you were to run the test, you did or did not get the same failure message as before. But if you keep running the tests it will fix itself and the test will become GREEN. So there must be some kind of timeout/threshold after which the module is reloaded… Uff again.
This does not look like a feasible path to test our DSC resources.
Giving up on actually running the resource I found there is this new cmdlet called
Invoke-DscResource which does exactly what we need, it let’s us call the Set, Get and Test methods of the resource. But unfortunately I can’t get it to work with class based DSC resources. I always get “resource not found” exception.
Another option would be to simply import the class, instantiate it and call the methods without using the
Invoke-DscResource cmdlet. But for some reason that does not work also. Unless the class is defined in the same file (not even in a script block) I can’t instantiate it. All of this fails:
So at the moment I don’t know how to test the class based resources, but there is new WMF preview published just few hours ago, so maybe this will change soon.