The Deployment Guys

Helping to deploy your world automagically...

Documenting your Task Sequences Automagically (Update - v2)

Documenting your Task Sequences Automagically (Update - v2)

  • Comments 34
  • Likes

A big thank you to those of you that tested the original XSL for the TaskSequence documentor and provided feedback.

This is v2 and includes some bug fixes:
    - Formats orphan steps with no Group
    - Added recursive template for Nested conditions for both groups and steps (tested to 3 levels)
    - Properly convert Not to Nor for conditions

For those of you that haven't used it - here is a re-post of the instructions:

1. Copy the attached file at the bottom of the post to the same folder as your task sequence.

2. Open your task sequence in your favourite text editor.

3. After the first line which should look something like this:

<?xml version="1.0"?> or <?xml version="1.0" encoding="utf-8"?>

enter the following as the second line:

<?xml-stylesheet type="text/xsl" href="tsDocumentorv2.xsl" mce_href="tsDocumentorv2.xsl"?>

4. Save your task sequence file and open it in Internet Explorer. Presto! The XSL takes care of formatting, indents and sizing.

Disclaimer: The information on this site is provided "AS IS" with no warranties, confers no rights, and is not supported by the authors or Microsoft Corporation. Use of included script samples are subject to the terms specified in the Terms of Use. 

This post was contributed by Aly Shivji a consultant with Microsoft Services - U.S. East Region.

Attachment: tsDocumentorv2.xsl
  • Works a treat, only snag was my own fault.. copied text of xsl and created the file rather than saving the xsl from the link.

  • Sorry I can't find a better place to ask this.  As someone who has been deploying images for 8 years using sysprep, Bart Boot CD and Ghost, I can really appreciate what you do.  I have a single image that covers 700 dekstop and laptop models which is great.  I would really like to take my processes to the next step with PXE Boot, ImageX, etc.  Problem is, I just have too many questions and I find a lot of the documentation to be difficult to follow.  I'm stuck in Windows XP by corporate declaration so, I have to reach around to understand any differences between the Vista oriented docs.  Anyway, without getting any deeper, I'm really looking to have this question answered:

    Is there any official training out there?  I have not seen such a thing.  I think I benefit most from classroom training and a lot of the subjects you cover assume I have a grasp on the basics of BDD (obviously I don't).

    Thanks and sorry if this is the wrong place to ask such a question.. you're definitely the right guys

  • Fred,

    You may want to check out the Desktop Deployment Planning Service resources at https://iwsolve.partners.extranet.microsoft.com/ddps/Resources.aspx and/or try to find a DDPS certified partner in your area.

    Good Luck,

    Aly

  • Thanks Aly,

    Never considered that there are consultants who could give me the knowledge, experience I crave.  We'll see what I can find and if I can convince my company to pay for such a thing.

  • Fred,

    I'd be glad to help with email or a phone conversation. There are some fundamentals with MDT and ConfigMgr OSD but once you have them the rest becomes common sense. As you have deployed builds before I reckon once you've had the opportunity to bounce your questions off someone you'll  be away, and this really is a great way to deploy your builds.

    Cheers,

    Carl

    carl262 at hotmail dot com

  • Great tool.  One question, though.  Is there a way to have a better visual separation between each task?  It all sort of runs together the way it is.  Even just a line between each one or alternating background colors.

  • I dug a bit into how to do xsl formatting and found the answer to my question so figured I'd share it.

    First, you need to set up the colors for the alternating rows.  To do this, replace the TD.step background color in the STYLE section with a TD.step_0 and TD.step_1.  Set them to the two colors that you want (I used FFF7E2 and FFF1BF which look OK).

    Then go through the rest of the document and look for lines that say "Class = "step"" and replace them with "Class="step_{position()  mod 2}"

    The code "position() mod 2" will return 0 for even lines, and 1 for odd lines, and use the background color step_0 or step_1 alternately.

    It's much easier to read that way.

  • Thanks Sam!

    - Aly

  • This is an awesome tool.

    To address Sam's quest a little further. I took each output and paste it into Excel. Then you can manipulate it however you want. In my case with SCCM I use 3 different tasks to get to a final product so this allowed me to put the whole process in excel so I have a final document to turn in.

    Chris S.

  • This awesome little tool was posted on the email list today. &#160; http://blogs.technet.com/deploymentguys

  • Dumb question...  We are using the exported TS, to edit and put stuff in the second line.

    Once we do add in the stuff in the second line, can that exported TS XML file STILL be used to import with, or, does the second line have to be removed?

    Thanks!

  • Great tool!!  Thank you!  Just curious since most of the SCCM data is in SQL, are there tools out there to capture settings for documentation?

  • This tool looks great - I have used since v1.  I still don't seem to be able to see custom variables though, e.g. WMI conditions/IF statements etc.  

    I have moved the steps to be only 1 layer down but still do not see the WMI conditions?

    example of condition (on either a group or a command line step):

    Select * FROM Win32_PnPEntity WHERE PNPDeviceID like"%10DF%"

  • I love this program, will you be making a version compatible with IE 9?

  • This doesn't work for me at all. Still just comes up as text, no formatting.

Your comment has been posted.   Close
Thank you, your comment requires moderation so it may take a while to appear.   Close
Leave a Comment