MDT/ConfigMgr – UDI – Having Multiple Configurations For the UDI Wizard (UDIWizard_Config.xml)

By default the UDI based task sequence will use the UDIWizard_Config.xml contained in your MDT 2010 Update 1 toolkit package.  What if you want to use the same toolkit package for multiple task sequences, but provided different versions of the UDI wizard? For example, if you have different domains you want to join, or possible different applications to be presented to the user, or even skip screens for some task sequences.  Well that is possible, but it’s buried in the documentation!

Reading The Documentation

First, here are the steps outlined in the MDT documentation under the section “Configure the OSD Setup Wizard Behavior.”

To override the configuration file that the Operating System Deployment (OSD) Setup Wizard uses

1.         In the Configuration Manager Console, go to Computer Management/Task Sequence.

2.         Right-click task_sequence (where task_sequence is the name of the task sequence you want to edit), and then click Edit.

3.         Beneath the State Capture phase, click the UDI Wizard task sequence step.

4.         On the Properties tab for the UDI Wizard task sequence step in Command line, modify the text as follows (where path is the path to the configuration file which is relative to the Scripts folder and file_name is the name of the configuration file)

(If you put the xml files in the \scripts folder of your toolkit package, you don’t need to specify a path value, just as you will see I didn’t specify a path in my example below):

cscript.exe “%DeployRoot%\Scripts\UDIWizard.wsf” /definition:path\file_name.xml.

Note   The above text appears on one line. The line wrap seen here is the result of document formatting constraints.

5.         Repeat steps 3 and 4, substituting State Capture with Preinstall/New Computer Only.

6.         Repeat steps 3 and 4 for any custom task sequence steps that run UDIWizard.wsf.

7.         Click OK.

Performing The Steps

Now, lets show you how to actally do that. 

First, in my toolkit package, you can see i have 2 definition xml’s:


Next, we will want to edit our task sequence:


First, we need to to go the first UDI Wizard step located under the State Capture phase:


Then we need to update our command line to add the /definition command and tell it what file to use, if you put the XML in the \scripts folder of the toolkit package then you won’t have to specify a path value here, you can just specify the file:


Perform the same actions for the UDI Wizard step under Preinstall/New Computer Only:


Perform this on any other custom step you might have added that calls the UDI Wizard, then click OK to save your changes:


Now, when we run the task sequence on our client, we’ll see the new welcome page i created to ensure that I’m using the new configuration instead of the default UDIWizard_Config.xml.


Using A Custom Variable To Define The XML

Now another interesting way to set a different XML is to take advantage of the MDT integration and use a custom variable.  This would allow you have a single task sequence that could call any number of UDI config xml’s.  You could take that a step further and use any number of MDT rules to define how that XML gets set, like based upon the location, or chassis type, or a plethora of other things, way cool! I think this is a fantastic idea and was proposed to me by Michael Niehaus in an email exchange we had.  So lets show you how to do that.

First lets change our task sequence to use a custom variable we’ll call “UDIXMLFile”.




Next we will need to configure the customsettings.ini file for our settings package for this task sequence. So here is the package I am going to modify.


Here is a bone stock customsettings.ini file:


Here we’ve added a custom property of “UDIXMLFile”, and we’ve configured a value of UDIXMLFile=UDIWizard_Config_2.xml


Next, save your changes and make sure to update the distribution point for your settings package. Again we launch the task sequence on our client to verify it’s using the XML file we want.


So how about an example were we set different XML’s based upon the DefaultGateway.  Here we’ll set a UDI config XML based upon whether you are in London or the United States. Maybe it’s something as simple as having a different welcome page message, or you’ve configured different OU’s to be selectable.  Here is an example customsettings.ini where we’ve configured either a UDIWizard_Config_2 or UDIWizard_Config_3 file to be used depending on where you are located.


Just a quick example to show you some of the possibilities. 

Hope this helps!


Leave a Reply


We use cookies to ensure the best possible experience on our website. Detailed information on the use of cookies on this site is provided in our Privacy and Cookie Policy. Further instruction on how to disable our cookies can be found there.