TSGui

Overview

TSGui from 20Road is an amazing utility for adding interactivity to your task sequences. Rather than having multiple task sequences for different builds that you required. You can have 1 with a build menu in, and it will set task sequence variables that you can hook in the task sequence as and when required.

Config

The TSGui gui is configured via an xml file where you can set up dropdown menu's, and checkboxes. Below is the one i am using, its a very simple build menu. This is called Config.xml and its placed in the TSGui folder.

<TsGui LiveData="TRUE" Output="ConfigMgr" PurgeInactive="TRUE">

  <Height>224</Height>
  <Width>300</Width>

  <HardwareEval />
  
  <Heading>
    <Title>IT Build Menu</Title>
    <Text>Build Menu</Text>
    <Bg-Color>#FF006AD4</Bg-Color>
    <Font-Color>#FFFFFF</Font-Color>
  </Heading>

  <Buttons>
    <Cancel>Cancel</Cancel>
    <Finish>Finish</Finish>
    <HideCancel>FALSE</HideCancel>
    <!-- Set this to TRUE to remove the cancel button from the GUI. -->
  </Buttons>

  <Footer>
    <Text></Text>
    <Height>17</Height>
    <HAlign>right</HAlign>
  </Footer>

  <Page>
    <Row>
      <Column>
        <Style>
          <Width>280</Width>
          <LeftCellWidth>110</LeftCellWidth>
          <RightCellWidth>160</RightCellWidth>
        </Style>

        <!-- GuiOptions -->

		<GuiOption Type="DropDownList" Sort="FALSE">
          <Variable>VAR_Windows</Variable>
          <Label>Windows Version:</Label>
          <SetValue>
            <Value>Windows 10</Value>
          </SetValue>
          <Option>
            <Text>Windows 10</Text>
            <Value>Windows10</Value>
          </Option>
          <Option>
            <Text>Windows 11</Text>
            <Value>Windows11</Value>
          </Option>
        </GuiOption>
		
		<GuiOption Type="DropDownList" Sort="True">
          <Variable>VAR_Site</Variable>
          <Label>Site - Build Type:</Label>
          <SetValue>
            <Value>Site1</Value>
          </SetValue>
          <Option>
            <Text>Site1</Text>
            <Value>Site1</Value>
          </Option>
          <Option>
            <Text>Site1 Clinical</Text>
            <Value>Site1_Clinical</Value>
          </Option>		  
          <Option>
            <Text>Site2</Text>
            <Value>Site2</Value>
          </Option>		  
          <Option>
            <Text>Site2 Clinical</Text>
            <Value>Site2_Clinical</Value>
          </Option>
        </GuiOption>
		
		<GuiOption Type="DropDownList" Sort="TRUE">
          <Variable>VAR_OfficeVersion</Variable>
          <Label>Office Version:</Label>
          <SetValue>
            <Value>No Office</Value>
          </SetValue>
          <Option>
            <Text>Office 365</Text>
            <Value>Office_365</Value>
          </Option>
          <Option>
            <Text>No Office</Text>
            <Value>No_Office</Value>
          </Option>
        </GuiOption>   
	  </Column>
    </Row>
  </Page>  
</TsGui>

When TSGui.exe is ran during OSD the xml file is read, and the menu appears.

You can change the heading text and the colour by changing the following section.

// Some code

  <Heading>
    <Title>IT Build Menu</Title>
    <Text>Build Menu</Text>
    <Bg-Color>#FF006AD4</Bg-Color>
    <Font-Color>#FFFFFF</Font-Color>
  </Heading>

Dropdown lists can also be added

// Some code

	<GuiOption Type="DropDownList" Sort="FALSE">
          <Variable>VAR_Windows</Variable>
          <Label>Windows Version:</Label>
          <SetValue>
            <Value>Windows 10</Value>
          </SetValue>
          <Option>
            <Text>Windows 10</Text>
            <Value>Windows10</Value>
          </Option>
          <Option>
            <Text>Windows 11</Text>
            <Value>Windows11</Value>
          </Option>
        </GuiOption>

Mine is a very simple build menu, my requirements are not that complex. In the root of the extracted folder there is a file called Config_demo.xml when ran it looks like this.

In the Config_Examples folder, there are many more examples.

Interactive Screen

When you run TSGui.exe inside Windows, you will see the test screen appear. And your build menu.

You can manipulate your build menu, and the log ouput will update to show you the current variable based on what you have changed.

Last updated