MDT Monitoring : WPF Deployment notifications

In this post, I will show you a way to monitor your MDT deployment and display a GUI when a computer is installed or when an error occurs during the deployment.

This time I used another way using a PowerShell GUI with MahApps.

This way you can use this method on Windows 10 but also on Windows 7 computers. In the example below I ran the notification script on the left computer. The right computer is being installed and once the deployment is completed the GUI appears on the left computer.

How to get the scripts ?

DOWNLOAD

PreRequisites

MDT Monitoring enabled on the server
MDT Monitor Service started on the server

This deployment notification can be used on any Windows 7 & Windows 10 computers. There is no need to run it on the MDT server, you can run it on a client computer.

How to use it ?

1/ Run the Monitoring.ps1 file and type the computer name to monitor, as below :

Don’t close the PowerShell windows, the script will analyze your deployments status !

2/ Once deployment is finished you will get a notification as below.

Deployment success notification

Once a deployment is completed successfully on a computer, the below GUI will appear :

In the example below the right computer, called computer2, is being deployed. The Monitoring.ps1 script has been launched on the left computer. Deployment completed successfully on computer2 and the a GUI notification is displayed on the left computer.

As you may noticed the GUI notification appears few seconds before the Final success wizard on the right computer.

Deployment error notification

If computer doesn’t answer for the past four hours, the deployment status will be Unresponsive, see below the warning you will get.

See below, the corresponding information using the Get-mdtmonitordata cmdlet.

As you can see, the deployment status is now set to 4.

If another error occurs you will get the below warning

As you may noticed the GUI appeared at 20:52 and using the Get-monitordata cmdlet, we can see that the Last time the computer has answered is 15:49.

The deploymentStatus will have the value 4 have five hours without any answers.

How it works?

First, you will need to type your deployment share and MDT module paths in the Monitoring_Infos.xml file, as below :

<monitoringinfos>
 <deploymentsharepath>\\myserver\Master-Images\DeploymentShare_Win10</DeploymentSharePath>
 <modulepath>C:\Program Files\Microsoft Deployment Toolkit\Bin</ModulePath>
</MonitoringInfos>

The MDT module path should be the path to the MicrosoftdeploymentToolkit.psd1 file.

By default, this file is located in the folder C:\Program Files\Microsoft Deployment Toolkit\Bin.

See below the main PS1 script, Monitoring.ps1

#================================================================================================================
#
# Script Part    : MDT Monitoring series
# Script purpose : Display a PowerShell GUI & Mahapps when a computer is successfully installed or when in case of error 
# Author    : Damien VAN ROBAEYS
# Twitter    : https://twitter.com/syst_and_deploy
# Blog        : http://www.systanddeploy.com/
#
#================================================================================================================
Param
 (
  [Parameter(Mandatory=$true)]
  [String]$Computer_Name
 )
$Global:Current_Folder=(get-location).path 
$Global:List_XML_Content= "$Current_Folder\Monitoring_Infos.xml"
$Input_XML= [xml](Get-Content$List_XML_Content)  
#************************************************************************** GET MONITORING INFOS FROM XML ******************************************************************************************************  
foreach($infosin$Input_XML.selectNodes("MonitoringInfos"))  
 {
  # Path of your DeploymentShare 
  # It will use the DeploymentSharePath node from the Monitoring_Infos.xml
  $Global:DeploymentSharePath= $infos.DeploymentSharePath 
  # Path of the MDT module. Path of the microsoftdeploymenttoolkit.psd1 file, by default in C:\Program Files\Microsoft Deployment Toolkit\Bin
  # You can also use the MDT Light module 
  # It will use the ModulePath node from the Monitoring_Infos.xml  
  $Global:MDT_module_Path= $infos.ModulePath  
 }  
#************************************************************************** IMPORT MDT MODULE ******************************************************************************************************
import-module"$MDT_module_Path\microsoftdeploymenttoolkit.psd1"
new-psdrive-name"DSManager"-psprovidermdtprovider-root$DeploymentSharePath
 
Do
 {
  $Get_Monitoring= get-mdtmonitordata-pathDSManager: | where {$_.name -eq"$Computer_Name"} 
  
   If($Get_Monitoring.DeploymentStatus -eq4)
   {
    $Global:Main_Text= "Deployment unresponsive"
    $Global:Low_Text= "$Computer_Name is unresponsive - $(get-date)"
    $Global:Percent_Status= $Get_Monitoring.percentcomplete  
    powershell-sta"$Current_Folder\Monitoring_Notif.ps1"-MainText"'$global:Main_Text'"-LowText"'$global:Low_Text'"-PercentStatus"'$global:Percent_Status'"
    break
   }
  ElseIf($Get_Monitoring.DeploymentStatus -eq3)
   {   
    $Global:Main_Text= "Deployment completed"
    $Global:Low_Text= "$Computer_Name is now ready - $(get-date)"
    $Global:Percent_Status= "100"
    powershell-sta"$Current_Folder\Monitoring_Notif.ps1"-MainText"'$global:Main_Text'"-LowText"'$global:Low_Text'"-PercentStatus"'$global:Percent_Status'"
    break
   } 
   
  ElseIf($Get_Monitoring.DeploymentStatus -eq2)
   {   
    $Global:Main_Text= "Deployment failed"
    $Global:Low_Text= "An error occured on $Computer_Name - $(get-date)"
    $Global:Percent_Status= $Get_Monitoring.percentcomplete  
    powershell-sta"$Current_Folder\Monitoring_Notif.ps1"-MainText"'$global:Main_Text'"-LowText"'$global:Low_Text'"-PercentStatus"'$global:Percent_Status'"
    break
   }     
 } 
while($Get_Monitoring.percentcomplete -lt100) 

The script will analyze your deployment and will return a notification in a WPF GUI. See below the PS1 script that will display the GUI.

#================================================================================================================
#
# Script Part    : MDT Monitoring series
# Script purpose : Display a PowerShell GUI & Mahapps when a computer is successfully installed or when in case of error 
# Author    : Damien VAN ROBAEYS
# Twitter    : https://twitter.com/syst_and_deploy
# Blog        : http://www.systanddeploy.com/
#
#================================================================================================================
param
 (
  [String]$MainText, 
  [String]$LowText,
  [String]$PercentStatus
 )
[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms')  | out-null
[System.Reflection.Assembly]::LoadWithPartialName('System.ComponentModel') | out-null
[System.Reflection.Assembly]::LoadWithPartialName('System.Data')           | out-null
[System.Reflection.Assembly]::LoadWithPartialName('System.Drawing')        | out-null
[System.Reflection.Assembly]::LoadWithPartialName('presentationframework') | out-null
[System.Reflection.Assembly]::LoadWithPartialName('PresentationCore')      | out-null
[System.Reflection.Assembly]::LoadFrom('assembly\MahApps.Metro.dll')       | out-null
[System.Reflection.Assembly]::LoadFrom('assembly\System.Windows.Interactivity.dll') | out-null
Add-Type-AssemblyName"System.Windows.Forms"
Add-Type-AssemblyName"System.Drawing"
functionLoadXml ($global:filename)
{
    $XamlLoader=(New-ObjectSystem.Xml.XmlDocument)
    $XamlLoader.Load($filename)
    return$XamlLoader
}
# Load MainWindow
$XamlMainWindow=LoadXml("Monitoring_Notif.xaml")
$Reader=(New-ObjectSystem.Xml.XmlNodeReader $XamlMainWindow)
$Form=[Windows.Markup.XamlReader]::Load($Reader)
$Title_Text= $Form.findname("Title_Text")
$ProgressStatusText= $Form.findname("ProgressStatusText")
$Global:Current_Folder=(get-location).path 
######################################################################################################################################################################################################## 
#*******************************************************************************************************************************************************************************************************
#                   VARIABLES DEFINITION 
#*******************************************************************************************************************************************************************************************************
########################################################################################################################################################################################################
########################################################################################################################################################################################################
########################################################################### BASIC VARIABLES ############################################################################################################
######################################################################################################################################################################################################## 
$Title_Text= $Form.findname("Title_Text")
$ProgressStatusText= $Form.findname("ProgressStatusText")
$Progress= $Form.findname("Progress")
$Monitor_Status= $Form.findname("Monitor_Status")
$ProgressPercent= $Form.findname("ProgressPercent")
$Title_Text.Content = $MainText
$Title_Text.Foreground = "Blue"
$ProgressStatusText.Content = $LowText
$ProgressPercent.Content = $PercentStatus+ "%"
If($MainText-eq"Deployment completed")
 {
  $Monitor_Status.ImageSource = "monitor_OK.png"
 }
ElseIf(($MainText-eq"Deployment unresponsive") -or($MainText-eq"Deployment failed"))
 {
  $Monitor_Status.ImageSource = "monitor_KO.png"
  $Title_Text.Foreground = "red"
 }
$Form.ShowDialog()# | Out-Null

See below the XAML file used to display the notification :

  xmlns:i="http://schemas.microsoft.com/expression/2010/interactivity"    
  xmlns:Controls="clr-namespace:MahApps.Metro.Controls;assembly=MahApps.Metro"
  Title="MDT Monitoring" 
  Width="350" 
  Height="200"  
  ResizeMode="NoResize" 
  WindowStartupLocation="CenterScreen"  
  >
  
 <Window.Resources>
  <resourcedictionary>
   <ResourceDictionary.MergedDictionaries>
    <!-- Create Metro Style  -->
                <resourcedictionary Source=".\resources\Icons.xaml" />
                <resourcedictionary Source=".\resources\custom.xaml" />     
    <resourcedictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Controls.xaml" />
    <resourcedictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Fonts.xaml" />
    <resourcedictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Colors.xaml" />
    <resourcedictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Accents/Cobalt.xaml" />
    <resourcedictionary Source="pack://application:,,,/MahApps.Metro;component/Styles/Accents/BaseLight.xaml" />
   </ResourceDictionary.MergedDictionaries>
  </ResourceDictionary>
 </Window.Resources>
  
    <Controls:MetroWindow.LeftWindowCommands>
        <Controls:WindowCommands> 
            <button>
                <stackpanel Orientation="Horizontal">
                    <rectangle Width="15" Height="15" Fill="{Binding RelativeSource={RelativeSource AncestorType=Button}, Path=Foreground}">
                        <Rectangle.OpacityMask>
                            <visualbrush Stretch="Fill" Visual="{StaticResource appbar_os_windows_8}" />
                        </Rectangle.OpacityMask>
                    </Rectangle>
                </StackPanel>
            </Button>  
        </Controls:WindowCommands>
    </Controls:MetroWindow.LeftWindowCommands>  
 
 <grid>
  <stackpanel Orientation="Vertical" HorizontalAlignment="Center" Margin="0,10,0,0">   
   <rectangle Margin="20,0,0,0" Width="60" Height="50">
    <Rectangle.Fill>
     <imagebrush x:Name="Monitor_Status"  />
    </Rectangle.Fill>
   </Rectangle> 
   <label x:Name="Title_Text" HorizontalAlignment="Center"  Margin="0,10,0,0" FontSize="18"></Label>   
   <label x:Name="ProgressStatusText" HorizontalAlignment="Center" Margin="0,0,0,0"></Label>
   <label x:Name="ProgressPercent" HorizontalAlignment="Center" Margin="0,0,0,0" FontSize="16"></Label>   
  </StackPanel>
 </Grid>
</Controls:MetroWindow>

Source : D. Van Robaeys, www.systanddeploy.com