Logging the time taken to run a Task Sequence using Powershell & Custom TS Vars – Part 2

If you haven’t already seen part one of this two part post then take a quick look now.

I read the following on technet: “Task Sequence variables can be read and written by using the Microsoft.SMS.TSEnvironment COM object while the task sequence is running.” The article then went on how to achieve this using VBScript.

So it was a simple matter of converting this to powershell.  Using their example, the ‘converted’ Powershell code looks like this:

$tsenv = New-Object -ComObject Microsoft.SMS.TSEnvironment

# You can query the environment to get an existing variable.
$logPath = $tsenv.value("_SMSTSLogPath")
# You can also set a variable in the OSD environment.
$tsenv.Value("MyCustomVariable") = $SomeVar

Further to the above example, we could then use Powershell to retrieve the custom task sequence variable created by using this code in a PS script:

#Put the Custom TS Variable into the Powershell Variable called: $MyVar to be used in the script later...
$MyVar = $tsenv.value("MyCustomVariable")

Now we have the basics under our belt, let’s crack on with what we want to achieve…

1.
Create a Custom TS Variable that will hold the time now.  At the end of the task sequence, we will retrieve this value and put it into a Powershell variable that will then be used to calculate the Total Time taken to image, as well as write this info to the registry.

So with that in mind, fire up the ISE (or whatever you use for scripting).  Here’s the Powershell code that I used to create the first custom variable:

$tsenv = New-Object -ComObject Microsoft.SMS.TSEnvironment
$tsenv.value("StartTime") = get-date -format HH:mm:ss

The above code simply gets the time right now and stuffs it into a task sequence variable called:StartTime

I saved this as ‘Set-TSVarTimeNow.ps1’ on my SCCM server where I store my normal application deployments.

2.
My next Task sequence variable isn’t really required as a TS variable as I am ‘hard-coding’ the value, (I do plan on reading this in via powershell at a later stage rather than the hard-code method), however I wanted at least two TS vars to play with while I was experimenting!  I decided to add a custom TS var for holding the name of the image being used.  My code looks like this:

$tsenv = New-Object -ComObject Microsoft.SMS.TSEnvironment
$tsenv.value("ImageName") = "Win7_x64_180814"

The above code simply stuffs the text “Win7_x64_180814” into a custom TS var called:ImageName

I saved this as ‘Set-TSVarImageName.ps1’ on my SCCM server where I store my normal application deployments.

NB: It is worth noting that I did not have to break each individual custom var into it’s own script, I could have had them all in one single Powershell script, however I think for readability within the Task Sequence, this is a bit clearer to other people.

3.
I then wrote the final Powershell script that brings all of the information together and writes the results to the computers registry.  I do not intend to teach Powershell at this point so I’ll leave you with my script to decipher, however you only require very basic Powershell skills to figure out what’s going on here:

A quick break down, if you open this script up in the ISE:

Lines 1 – 25 Declares a function (Get-TimeDifference) that takes a start and end time and produces an object containing a StartTime, EndTime and TimeDifference.  If you do not declare a start or end time then the current time is used.

Lines 27 – 35 Read in the custom TS vars we created earlier into Powershell variables for processing later in the script.

Line 38 Calls the function Get-TimeDifference and feeds it the start time which was retrieved from our custom task sequence variable ‘startTime’ (See lines 31 and 32)

Lines 41 – 60 Create the reg Keys and add the values (You may wish to adjust this part to meet your organisational needs)

The script is called ‘WriteRegKeys.ps1’

You can view \ download all three of these scripts from GitHub in my Powershell repo in the SCCM directory: Set-TSVarTimeNow.ps1, Set-TSVarImageName.ps1,WriteRegKeys.ps1

4.
The next task is to create packages from the scripts you just created in steps 1,2 and 3 above using the Configuration Manager console.  I saved both Set-TsVarTimeNow and Set-TSVarImageName.ps1 to the same location, and the WriteRegKeys.ps1 to a separate location on my Config manager server.  You don’t necessarily need to create an individual package per script.

I’m assuming that you know how to create an ‘old-school’ type package with no program required.  I’ll walk you through creating the one that contains the two PS scripts together just in case..

a) In the config Manager console, on the Software Library section, Right-Click the Packages node and select New Package:

a - new package

b) Give the package a meaningful name and browse to the location on your Config Manager server to the directory that contains your two Powershell scripts created in steps 1 and 2 above:

b - packageDetails

c) Choose ‘Do not create a program’:

c - DoNotCreateProgram

d) Next , next  finish….

5.
You should now have two programs, I named mine: Set Custom TSVars (This one contains the two scripts that set the custom variables), and the other I named: WriteRegKeys

d - Programs

 

Don’t forget to upload them to your distribution point.

6.
Now in your imaging task sequence, I found that the earliest I could place the setting of the custom variable that will hold the imaging start time is immediately after the disk formatting.  As the formatting is the first part of the task sequence, we only loose around 15 seconds while it formats and then it writes the start time to our custom variable. (As a side note I did experiment with writing the custom var to a text file as a prestart command in the boot image and reading in the text file later, however, this could prove more inaccurate as there may be a long pause between the start time and the time the tech actually kicks the image off.  I intend to solve this issue when I start writing the custom front end which is what kicked this whole investigation off in the first place!)

With all that rambling out of the way, you need to add 3 ‘Run Powershell Script’ tasks within your task sequence:
Two as close to the start that you can that set the custom variables and one as the last task in your sequence that will calculate the total time and write to the registry:

e - Task locations

7.
Here is what the properties of the 3  ‘Run Powershell Script’ look like:

script1Props

script2Props

script3Props

8.
That’s it.  I hope this has been helpful.

As a reminder in case you never saw part 1 of this article, here’s the finished result:

SCCM TS Registry results

Now that you have figured this out, the world is your oyster!  I will be writing a custom Front End for imaging based off the back of this and I’ll post as soon as I have something worthy.

2 Comments

  1. Did you ever create a version of this script where the imagename was not hardcoded, but read from SCCM during the task sequence. That way I can use the script with different images without having to create a Set-TSVarImageName.ps1 for every image we have 🙂

    • I never did – I no longer work there and so it never got done! I will be installing SCCM at my new workplace and can look again then, however it is quite a way off as I am still in the project planning stage.

Leave a Reply

Your email address will not be published.


*