SCCM – SCCMOG – Deployment Blog

30th November 2018

Windows 10 Inject Start Menu Layout Offline – MDT SCCM OSD Powershell

In this blog I will show you how to inject your Windows 10 start menu offline so that on first boot its already configured in your reference image or even your deployment task sequence whether that be MDT of ConfigMgr (SCCM).

GITHUB: Action-OSD_InjectStartMenu_Offline.ps1

Note: If you have links for icons pinned on the taskbar and the software is not already installed it ill not break and they will show as the applications are installed 😉

Important: Make sure you have added the PowerShell component to your boot image. Click a link to find out how: MDT or SCCM

MDT Setup

First download the script and save it into you deployment share “Scripts” folder:

J:\<YOUR_DEPLOYMENT_SHARE>\Scripts\Action-OSD_InjectStartMenu_Offline.ps1

1	J:\<YOUR_DEPLOYMENT_SHARE>\Scripts\Action-OSD_InjectStartMenu_Offline.ps1

- Your welcome to also download the DefaultStart.xml and or just rename your default start menu XML to “DefaultStart.xml” and add it also to the deployment share “Scripts” folder.

J:\<YOUR_DEPLOYMENT_SHARE>\Scripts\DefaultStart.xml

1	J:\<YOUR_DEPLOYMENT_SHARE>\Scripts\DefaultStart.xml

Then open up your chosen Task Sequence in MDT and just before the “Inject Drivers” step under the “Post Install Group” and a new “Run Commmand Line Step”.
Name it for example: Inject Start Menu Offline
Then use the following command line:

Powershell.exe -ExecutionPolicy Bypass -File "%SCRIPTROOT%\Action-OSD_InjectStartMenu_Offline.ps1"

1	Powershell.exe -ExecutionPolicy Bypass -File "%SCRIPTROOT%\Action-OSD_InjectStartMenu_Offline.ps1"

Example:

SCCM Setup

For SCCM you must be using the MDT integration (if you’re not… Start now!), you can make it work without it but I will not cover that here.
Find your current MDT Toolkit Package that is associated with the Task Sequence you would like to configure power settings in.
Open the “Source” location of your toolkit package, then open the scripts folder.

Once inside the scripts folder copy the “Action-OSD_InjectStartMenu_Offline.ps1” into it. And then your welcome to also download the DefaultStart.xml or just rename your default start menu XML to “DefaultStart.xml” and add it also to the ToolKit Package “Scripts” foldera also.
Now, update the Package in ConfigMgr.
Next we need to add the step to the task sequence. It must go after a “Use Toolkit Package” step and before your Driver injection step in the task sequence. (If you have a reboot remember to add another use “Toolkit package”.)

Create a new “Run Command Line Step” and the below command.

Powershell.exe -ExecutionPolicy Bypass -File "%DEPLOYROOT%\Action-OSD_InjectStartMenu_Offline.ps1"

1	Powershell.exe -ExecutionPolicy Bypass -File "%DEPLOYROOT%\Action-OSD_InjectStartMenu_Offline.ps1"

And that is it. Your ConfigMgr or MDT Task sequence is now setup to inject the default start menu before the machine boots!

Anyway as always, script is provided as is and if you do mod it, there is a line to add your name.

30th November 201830th November 2018

Windows 10 Configure User Experience Offline – MDT SCCM OSD -VBScript

So currently I am working on an Government Education site comprising of just under 40 schools. There was a requirement to remove/hide Microsoft’s Edge browser from the image being rolled out to the users. The reasoning behind this is down to a monitoring tool used by the education department that does not support Edge and therefor policies would be broken…

Anyway I hunted around on our favourite resource for a solution that would not break the image entirely by removing one of it core features.

Eventually I found these 4 registry keys that did the trick:

KEY: HKEY_LOCAL_MACHINE\NewOS\Microsoft\Windows\CurrentVersion\Explorer
Name: DisableEdgeDesktopShortcutCreation 
Value: 1

KEY: HKEY_LOCAL_MACHINE\NewOS\Microsoft\Windows\CurrentVersion\Explorer

Name: DisableEdgeDesktopShortcutCreation

Value: 1

KEY: HKEY_LOCAL_MACHINE\NewOS\Policies\Microsoft\MicrosoftEdge\Main
Name: PreventFirstRunPage
Value: 1

KEY: HKEY_LOCAL_MACHINE\NewOS\Policies\Microsoft\MicrosoftEdge\Main

Name: PreventFirstRunPage

Value: 1

KEY: HKEY_LOCAL_MACHINE\NewOS\Policies\Microsoft\MicrosoftEdge\Main
Name: AllowPrelaunch 
Value: 0

KEY: HKEY_LOCAL_MACHINE\NewOS\Policies\Microsoft\MicrosoftEdge\Main

Name: AllowPrelaunch

Value: 0

KEY: HKEY_LOCAL_MACHINE\NewOS\Policies\Microsoft\MicrosoftEdge\TabPreloader\AllowTabPreloading
Name: AllowTabPreloading 
Value: 0

KEY: HKEY_LOCAL_MACHINE\NewOS\Policies\Microsoft\MicrosoftEdge\TabPreloader\AllowTabPreloading

Name: AllowTabPreloading

Value: 0

Next was to figure out how to inject these into my reference image before it was laid onto the VM for automated customisation. So I remembered a great script by Johan Arwidmark I use all the time for turning off Appx package updates during a reference image capture task sequence (can break sysprep if allowed).

Anyway after a bit of modification to load the Software registry hive offline instead this is what I came up with. There is also some commented out portions here that may come in handy:

Github: Config-Win10-Offline-UE.wsf

MDT Setup

First download the script and save it into you deployment share “Scripts” folder:

J:\<YOUR_DEPLOYMENT_SHARE>\Scripts\Config-Win10-Offline-UE.wsf

1	J:\<YOUR_DEPLOYMENT_SHARE>\Scripts\Config-Win10-Offline-UE.wsf

Then Open up your chosen Task Sequence in MDT and just before the “Inject Drivers” step under the “Post Install Group” and a new “Run Commmand Line Step”.
Name it for example: Configure User Experience
Then use the following command line:

cscript.exe "%SCRIPTROOT%\Config-Win10-Offline-UE.wsf"

1	cscript.exe "%SCRIPTROOT%\Config-Win10-Offline-UE.wsf"

Example:

SCCM Setup

For SCCM you must be using the MDT integration (if you’re not… Start now!), you can make it work without it but I will not cover that here.
Find your current MDT Toolkit Package that is associated with the Task Sequence you would like to configure power settings in.
Open the “Source” location of your toolkit package, then open the scripts folder.

Once inside the scripts folder copy the “Config-Win10-Offline-UE.wsf” into it. Now, update the Package in ConfigMgr.
Next we need to add the step to the task sequence. It must go after a “Use Toolkit Package” step and before your Driver injection step in the task sequence. (If you have a reboot remember to add another use “Toolkit package”.)

Create a new “Run Command Line Step” and add the below command.

cscript.exe "%deployroot%\scripts\Config-Win10-Offline-UE.wsf"

1	cscript.exe "%deployroot%\scripts\Config-Win10-Offline-UE.wsf"

And that is it. Your ConfigMgr or MDT Task sequence is now setup to configure the user environment before the machine boots!

Anyway as always, script is provided as is and if you do mod it, there is a line to add your name.

27th September 2018

Get and Set ConfigMgr Machine Variables with WMI and PowerShell Functions

So I’m working on a client site at the moment with a difficult to automate OU structure. Essentially I need to be able to add and get ConfigMgr machine variables easily and without the need of the PowerShell module.

So as we do… I went to google, found a couple of nice hints then though I’d write them into functions to be easily re-used.

The beauty of these functions is they can be run from anywhere in your site or during a task sequence as they use WMI.
This means as long as the account running the script has access to the ConfigMgr site you can play with variables!

Anyway download the most up to date versions of the functions from the SCCMOG GitHub Repo:

Scripts:

#Get-ConfigMgrMachineVariableWMI
#SCCMOG.com Richie Schuster - 27/09/18
#Gets the value of a ConfigMgr Objects Variable
#E.g <Get-ConfigMgrMachineVariable -Siteserver $Siteserver -SiteCode $SiteCode -MachineName TUDOR -VarName "Hello2">
#Returns blank string if not found and value if found.
Function Get-ConfigMgrMachineVariable{
	param(
		[parameter(Mandatory=$true, HelpMessage="Site server FQDN")]
		[ValidateNotNullOrEmpty()]
		[string]$Siteserver,

		[parameter(Mandatory=$true, HelpMessage="SCCM Site Code")]
		[ValidateNotNullOrEmpty()]
		[string]$SiteCode,

		[parameter(Mandatory=$true, HelpMessage="ConfigMgr Machine Object to add Variable to")]
		[ValidateNotNullOrEmpty()]
		[string]$MachineName,

		[parameter(Mandatory=$true, HelpMessage="Variable Name to query for.")]
		[ValidateNotNullOrEmpty()]
		[string]$VarName
	)
    #Set to null
    $objMachineSettings = $null
    #Get machine object from ConfigMgr
    $objComputer = gwmi -computername $($Siteserver) -namespace "root\sms\site_$($SiteCode)" -class "sms_r_system" | where{$_.Name -eq $MachineName}
    #Get settings from ConfigMgr
    $objMachineSettings = gwmi -computername $($Siteserver) -namespace "root\sms\site_$($SiteCode)" -class "sms_machinesettings" | where{$_.ResourceID -eq $objComputer.ResourceID}
    If ($objMachineSettings -ne $null){
        $objMachineSettings.get()
        If ($objMachineSettings.MachineVariables | where{$_.Name -eq "$VarName"}) {
            $variable = (($objMachineSettings.MachineVariables | where{$_.Name -eq "$VarName"}).Value).Trim()
            return $variable
        }
        Else {
            $variable = ""
            return $variable
        }
    }
    else {
        $variable = ""
        return $variable
    }   
}

#Get-ConfigMgrMachineVariableWMI

#SCCMOG.com Richie Schuster - 27/09/18

#Gets the value of a ConfigMgr Objects Variable

#E.g <Get-ConfigMgrMachineVariable -Siteserver $Siteserver -SiteCode $SiteCode -MachineName TUDOR -VarName "Hello2">

#Returns blank string if not found and value if found.

Function Get-ConfigMgrMachineVariable{

param(

[parameter(Mandatory=$true, HelpMessage="Site server FQDN")]

[ValidateNotNullOrEmpty()]

[string]$Siteserver,

[parameter(Mandatory=$true, HelpMessage="SCCM Site Code")]

[ValidateNotNullOrEmpty()]

[string]$SiteCode,

[parameter(Mandatory=$true, HelpMessage="ConfigMgr Machine Object to add Variable to")]

[ValidateNotNullOrEmpty()]

[string]$MachineName,

[parameter(Mandatory=$true, HelpMessage="Variable Name to query for.")]

[ValidateNotNullOrEmpty()]

[string]$VarName

)

#Set to null

$objMachineSettings = $null

#Get machine object from ConfigMgr

$objComputer = gwmi -computername $($Siteserver) -namespace "root\sms\site_$($SiteCode)" -class "sms_r_system" | where{$_.Name -eq $MachineName}

#Get settings from ConfigMgr

$objMachineSettings = gwmi -computername $($Siteserver) -namespace "root\sms\site_$($SiteCode)" -class "sms_machinesettings" | where{$_.ResourceID -eq $objComputer.ResourceID}

If ($objMachineSettings -ne $null){

$objMachineSettings.get()

If ($objMachineSettings.MachineVariables | where{$_.Name -eq "$VarName"}) {

$variable = (($objMachineSettings.MachineVariables | where{$_.Name -eq "$VarName"}).Value).Trim()

return $variable

}

Else {

$variable = ""

return $variable

}

else {

$variable = ""

return $variable

}

#Set-ConfigMgrMachineVariableWMI
#SCCMOG.com Richie Schuster - 27/09/18
#Gets the value of a ConfigMgr Objects Variable
#E.g <Set-ConfigMgrMachineVariable -Siteserver ROARY-CM-01 -SiteCode ROR -MachineName TUDOR -VarName Hello2 -VarValue Really -VarMasked $false>
#Sets ConfigMgr Variable - will add a new variable if others already set.
Function Set-ConfigMgrMachineVariable {
	param(
		[parameter(Mandatory=$true, HelpMessage="Site server FQDN")]
		[ValidateNotNullOrEmpty()]
		[string]$Siteserver,

		[parameter(Mandatory=$true, HelpMessage="SCCM Site Code")]
		[ValidateNotNullOrEmpty()]
		[string]$SiteCode,

		[parameter(Mandatory=$true, HelpMessage="ConfigMgr Machine Object to add Variable to")]
		[ValidateNotNullOrEmpty()]
		[string]$MachineName,

		[parameter(Mandatory=$true, HelpMessage="Variable Name")]
		[ValidateNotNullOrEmpty()]
		[string]$VarName,

		[parameter(Mandatory=$true, HelpMessage="Variable Value")]
		[ValidateNotNullOrEmpty()]
		[string]$VarValue,

		[parameter(Mandatory=$false, HelpMessage="Mask variable - `$true or `$false - Default is `$false")]
		[ValidateNotNullOrEmpty()]
		[bool]$VarMasked = $false
	)
    #Set to null
    $objMachineSettings = $null
    #Get machine resource id
    $objComputer = gwmi -computername $($Siteserver) -namespace "root\sms\site_$($SiteCode)" -class "sms_r_system" | where{$_.Name -eq $MachineName}
    #Get SMS Machine Settings Class
    $objSMSMachineSettings = [WmiClass]"\\$($Siteserver)\ROOT\SMS\site_$($SiteCode):SMS_MachineSettings"
    #Get SMS Machine settings Instances
    $objSMSMachineSettings.GetInstances() | Out-Null
    #Get Machine Settings
    $objMachineSettings = gwmi -computername $($Siteserver) -namespace "root\sms\site_$($SiteCode)" -class "sms_machinesettings" | where{$_.ResourceID -eq $objComputer.ResourceID}

    #test if variables already present
    If ($objMachineSettings -ne $null){
        $objMachineSettings.Get()  
        #Get new array index
        if ($objMachineSettings.MachineVariables.length -ne 0){
            $i = 0
            $newVarIndex = $i
            DO {
            $newVarIndex = $i + 1
            $i++
            } While ($i -le $objMachineSettings.MachineVariables.length - 1)
            $newVarIndex
        }
        else {
            $newVarIndex = 0
        }
        #Create the new emty variable
        $objMachineSettings.MachineVariables = $objMachineSettings.MachineVariables += [WmiClass]"\\$($Siteserver)\ROOT\SMS\site_$($SiteCode):SMS_MachineVariable"
        #get array of variables
        $arrayMachineVariables = $objMachineSettings.MachineVariables
        #set new variable
        $arrayMachineVariables[$newVarIndex].name=$varName
        $arrayMachineVariables[$newVarIndex].value=$VarValue
        $arrayMachineVariables[$newVarIndex].ismasked = $VarMasked
    }
    Else {
        #Create Machine instance
        $objMachineSettings = $objSMSMachineSettings.CreateInstance()
        #Create base properties
        $objMachineSettings.psbase.properties["ResourceID"].value = $($objComputer.ResourceID)
        $objMachineSettings.psbase.properties["SourceSite"].value = $($SiteCode)
        $objMachineSettings.psbase.properties["LocaleID"].value = 1033
        #Create empty variable
        $objMachineSettings.MachineVariables = $objMachineSettings.MachineVariables + [WmiClass]"\\$($Siteserver)\ROOT\SMS\site_$($SiteCode):SMS_MachineVariable"
        #get array of variables
        $arrayMachineVariables = $objMachineSettings.MachineVariables
        #set the new variable
        $arrayMachineVariables[0].name=$varName
        $arrayMachineVariables[0].value=$VarValue
        $arrayMachineVariables[0].ismasked = $VarMasked
    }
    # write the variables back to the machine object 
    $objMachineSettings.MachineVariables = $arrayMachineVariables
    #Save the new Variable
    $objMachineSettings.put()
}

#Set-ConfigMgrMachineVariableWMI

#SCCMOG.com Richie Schuster - 27/09/18

#Gets the value of a ConfigMgr Objects Variable

#E.g <Set-ConfigMgrMachineVariable -Siteserver ROARY-CM-01 -SiteCode ROR -MachineName TUDOR -VarName Hello2 -VarValue Really -VarMasked $false>

#Sets ConfigMgr Variable - will add a new variable if others already set.

Function Set-ConfigMgrMachineVariable {

param(

[parameter(Mandatory=$true, HelpMessage="Site server FQDN")]

[ValidateNotNullOrEmpty()]

[string]$Siteserver,

[parameter(Mandatory=$true, HelpMessage="SCCM Site Code")]

[ValidateNotNullOrEmpty()]

[string]$SiteCode,

[parameter(Mandatory=$true, HelpMessage="ConfigMgr Machine Object to add Variable to")]

[ValidateNotNullOrEmpty()]

[string]$MachineName,

[parameter(Mandatory=$true, HelpMessage="Variable Name")]

[ValidateNotNullOrEmpty()]

[string]$VarName,

[parameter(Mandatory=$true, HelpMessage="Variable Value")]

[ValidateNotNullOrEmpty()]

[string]$VarValue,

[parameter(Mandatory=$false, HelpMessage="Mask variable - `$true or `$false - Default is `$false")]

[ValidateNotNullOrEmpty()]

[bool]$VarMasked = $false

)

#Set to null

$objMachineSettings = $null

#Get machine resource id

$objComputer = gwmi -computername $($Siteserver) -namespace "root\sms\site_$($SiteCode)" -class "sms_r_system" | where{$_.Name -eq $MachineName}

#Get SMS Machine Settings Class

$objSMSMachineSettings = [WmiClass]"\\$($Siteserver)\ROOT\SMS\site_$($SiteCode):SMS_MachineSettings"

#Get SMS Machine settings Instances

$objSMSMachineSettings.GetInstances() | Out-Null

#Get Machine Settings

$objMachineSettings = gwmi -computername $($Siteserver) -namespace "root\sms\site_$($SiteCode)" -class "sms_machinesettings" | where{$_.ResourceID -eq $objComputer.ResourceID}

#test if variables already present

If ($objMachineSettings -ne $null){

$objMachineSettings.Get()

#Get new array index

if ($objMachineSettings.MachineVariables.length -ne 0){

$i = 0

$newVarIndex = $i

DO {

$newVarIndex = $i + 1

$i++

} While ($i -le $objMachineSettings.MachineVariables.length - 1)

$newVarIndex

}

else {

$newVarIndex = 0

}

#Create the new emty variable

$objMachineSettings.MachineVariables = $objMachineSettings.MachineVariables += [WmiClass]"\\$($Siteserver)\ROOT\SMS\site_$($SiteCode):SMS_MachineVariable"

#get array of variables

$arrayMachineVariables = $objMachineSettings.MachineVariables

#set new variable

$arrayMachineVariables[$newVarIndex].name=$varName

$arrayMachineVariables[$newVarIndex].value=$VarValue

$arrayMachineVariables[$newVarIndex].ismasked = $VarMasked

}

Else {

#Create Machine instance

$objMachineSettings = $objSMSMachineSettings.CreateInstance()

#Create base properties

$objMachineSettings.psbase.properties["ResourceID"].value = $($objComputer.ResourceID)

$objMachineSettings.psbase.properties["SourceSite"].value = $($SiteCode)

$objMachineSettings.psbase.properties["LocaleID"].value = 1033

#Create empty variable

$objMachineSettings.MachineVariables = $objMachineSettings.MachineVariables + [WmiClass]"\\$($Siteserver)\ROOT\SMS\site_$($SiteCode):SMS_MachineVariable"

#get array of variables

$arrayMachineVariables = $objMachineSettings.MachineVariables

#set the new variable

$arrayMachineVariables[0].name=$varName

$arrayMachineVariables[0].value=$VarValue

$arrayMachineVariables[0].ismasked = $VarMasked

}

# write the variables back to the machine object

$objMachineSettings.MachineVariables = $arrayMachineVariables

#Save the new Variable

$objMachineSettings.put()

}

28th July 20183rd August 2018

PowerShell add DaRT Remote Control to SCCM Boot Image Early V2

Ok so I’m sure like a lot of people out there we all love those scripts that Johan Arwidmark, Mikael Nystrom, Peter Löfgren and all the other MVPs write that make our lives easier!

Any way Johan recently released an awesome PowerShell script to inject DaRT into a ConfigMgr boot image and configure remote control from the MDT Monitoring node using a launching script written by Alexey Semibratov.
Adding DaRT to ConfigMgr Boot Images – And starting it earlier than early

The beauty of adding this to your boot image is the point at which you are then able to remote control a task sequence, you can literally remote control the machine being built before the DP password has been entered, allowing the ConfigMgr Admin(s) to easily troubleshoot an issue.

I want to make it clear that the original script was created by Johan and without his work I would not have come up with this. What I have done (having a spare Saturday) is tweak it a little to take parameters and configure it all. This means you do not have to open any files to change any information 🙂 I even update the XML for you, install Dart, the works!

Anyway head over to here to download the script: Add-DartToBootImageV2

The steps for configuration are as follows:

Create a folder to drop the Add-DartToBooImageV2 files into. E.g “E:\Setup\Scripts\Add-DartToBooImageV2” Note: no spaces please 🙂

Folder structure for Add-DarttobootimageV2

Copy all script files downloaded from above and your version of the MSDaRT100.MSI (DaRT 10 x64) installer into that folder as well.
Next head over to you MDT deployment share and grab the monitoring service address.

MDT Deployment Share Monitoring Host Address

Now head over to ConfigMgr and grab the Name of the boot image you would like to enable DaRT remote control on.
Once you have collected that information open a command prompt as Administrator on your site server.
Now navigate (cd) to E:\Setup\Scripts\Add-DartToBooImageV2
Ensure the drive you choose has enough space to mount the boot image as the script will create and clean up for you.
And run the script with the following command line:

.\Add-DartToBootImageV2.ps1 -EventServiceLocation http://your-cm-01.yourdomain.local:9800 -BootImageName 'MDT 8450 x64' -MountDrive J -SiteServer your-cm-01.yourdomain.local -SiteCode P01

1	.\Add-DartToBootImageV2.ps1 -EventServiceLocation http://your-cm-01.yourdomain.local:9800 -BootImageName 'MDT 8450 x64' -MountDrive J -SiteServer your-cm-01.yourdomain.local -SiteCode P01

Running the script:

Reaping the rewards:

The script:

##################################################################################################################
#
#  Original Author: Johan Arwidmark <https://deploymentresearch.com/Research/Post/670/Adding-DaRT-to-ConfigMgr-Boot-Images-And-starting-it-earlier-than-early> 
#  Updated By: Richie Schuster - C5 Alliance - SCCMOG.com
#  Date:   28/07/2018
#          03/08/2018 - Changed Folder search to get volume and select on data drives only as found issue on VMware VMs
#                       Added default paths for installs MDT and Dart to speed up script for multiple Images.
#                       
#  Script: Add-DartToBootImageV2.ps1
#  Usage: Powershell.exe -ExecutionPolicy Bypass -File .\Add-DartToBootImageV2.ps1 -EventServiceLocation http://roary-cm-01.roary.local:9800 -BootImageName 'MDT 8450 x64' -MountDrive J -SiteServer ROARY-CM-01.ROARY.LOCAL -SiteCode ROR
#
##################################################################################################################

param(
    [parameter(Mandatory=$true, HelpMessage="Please enter the FQDN and PortNumber of the Server that host the MDT Monitoring Service. E.g http://roary-cm-01.roary.local:9800")]
    [ValidateNotNullOrEmpty()]
    [string]$EventServiceLocation,
    [parameter(Mandatory=$true, HelpMessage="Please enter the name of the bootimage you would like to inject DaRT into.")]
    [ValidateNotNullOrEmpty()]
    [string]$BootImageName,
    [parameter(Mandatory=$true, HelpMessage="Please select the Mount Drive i.e <J>")]
    [ValidateNotNullOrEmpty()]
    [string]$MountDrive,
    [parameter(Mandatory=$true, HelpMessage="Please enter the FQDN of your Site Server")]
    [ValidateNotNullOrEmpty()]
    [string]$SiteServer,
    [parameter(Mandatory=$true, HelpMessage="Please enter you Site Code.")]
    [ValidateNotNullOrEmpty()]
    [string]$SiteCode
)

# Check for elevation
Write-Host "Checking for elevation"

If (-NOT ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole(`
    [Security.Principal.WindowsBuiltInRole] "Administrator"))
{
    Write-Warning "Oupps, you need to run this script from an elevated PowerShell prompt!`nPlease start the PowerShell prompt as an Administrator and re-run the script."
    Write-Warning "Aborting script..."
    Break
}

# Connect to ConfigMgr
if((Get-Module ConfigurationManager) -eq $null) {
    Import-Module "$($ENV:SMS_ADMIN_UI_PATH)\..\ConfigurationManager.psd1"
}
if((Get-PSDrive -Name $SiteCode -PSProvider CMSite -ErrorAction SilentlyContinue) -eq $null) {
    New-PSDrive -Name $SiteCode -PSProvider CMSite -Root $SiteServer 
}
Set-Location "$($SiteCode):\" 

# Get Boot image from ConfigMgr
$BootImage = Get-CMBootImage -Name $BootImageName
$BootImagePath = $BootImage.ImagePath
$XMLPath = "$PSScriptRoot\Unattend.xml"
$EnableDart = "$PSScriptRoot\EnableDart.wsf"
$SampleFiles = "$PSScriptroot"
$MountPath = "$($MountDrive):\DartMount"
$MDTDefaultPath = "C:\Program Files\Microsoft Deployment Toolkit\Templates"
$MDTFolderName = "Microsoft Deployment Toolkit\Templates"
$REGUninstall = "HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall"
$DartDefaultPath = "C:\Program Files\Microsoft DaRT"
$DartDispName = 'Microsoft Dart 10'
$DartFolderName = "Microsoft DaRT"
$DartMSI = "$PSScriptroot\MSDaRT100.msi"

#Function to find folders
Function FindFolder($FolderName){
    #$Drives = Get-PSDrive -p FileSystem | Select-Object -ExpandProperty Name
    $Drives =  Get-Volume | Where-Object { ($_.FileSystemLabel -ne "System Reserved") -and ( $_.DriveType -like "Fixed") -and ( $_.FileSystem -like "NTFS")} | Select-Object -ExpandProperty DriveLetter | Sort-Object
    $InstallPath = $null
    :findfolder Foreach ($drive in $Drives) {
        If ($InstallPath -eq $null) {
            $Counter++
            Write-host "Searching drive $($drive):\ for folder: '$($FolderName)' Drive count is $($Counter) out of $($Drives.Count)" -ForegroundColor Yellow
            $InstallPath = Get-ChildItem -Recurse -Force "$($drive):\" -ErrorAction SilentlyContinue | Where-Object { ($_.PSIsContainer -eq $true) -and ( $_.FullName -like "*$FolderName") } | Select-Object -ExpandProperty FullName
        }
        Else {
                Write-Host "Found folder at: $($InstallPath)" -ForegroundColor Green
                return $InstallPath
                break findfolder
        }
    }
    #Write-Warning "Could not find the install Folder $Foldername exiting";break
    $InstallPath = "NotFound"
    return $InstallPath
}

# Check for PRE Reqs
Set-Location C:
if (!(Test-Path -Path "$XMLPath")) {Write-Warning "Could not find Unattend.xml path, check it is in script root and retry. aborting...";Break}
if (!(Test-Path -Path "$BootImagePath")) {Write-Warning "Could not find boot image, aborting...";Break}
if (!(Test-Path -Path "$DartMSI")) {Write-Warning "Could not DaRT MSI, Please place MSDaRT100.msi in script root folder, aborting...";Break}
if (!(Test-Path -Path "$MountPath")) {
    Write-Warning "Could not find mount path, Creating..."
    try {
        New-item -Path "$MountPath" -ItemType Directory -ErrorAction SilentlyContinue -Force
        Write-Host "Successfully Created Mount Path at:  $($MountPath)" -ForegroundColor Green
    }
    catch [System.Exception]{
        Write-Host "Failed to create Mount Path at:  $($MountPath) Error Message:  $($_.Exception.Message)";Break
    }
    }
#Check if dart is installed - If not install it.
$DaRT10 = Get-ItemProperty "$REGUninstall\*" | Where-Object DisplayName -Like $DartDispName
if($DaRT10.VersionMajor -eq “10”){
    Write-Host "Dart is installed searching for CAB file location"
    If (Test-Path -Path $DartDefaultPath){
        $DartInstallPath = $DartDefaultPath
    }
    Else {
        $DartInstallPath = FindFolder($DartFolderName)
    }
    $DartCab = $DartInstallPath + "\v10\Toolsx64.cab"
    if (Test-Path -Path "$DartCab"){
        Write-Host "Found DaRT x64 CAB at: $($DartCab)" -ForegroundColor Green
    } 
    else {
        Write-Warning "Could not find DaRT 10 Toolsx64.cab, Please remove older version of DaRT and retry. aborting...";
        Break
    }
}
else{
    Write-Warning "Could not find any DaRT version installed. Installing DaRT MSI in root of folder."
    $DartArgs = "/i $DartMSI /qb /norestart /L*v $env:windir\temp\MSDaRT100_Install.Log"
    $process = Start-Process -FilePath "msiexec.exe" -ArgumentList $DartArgs -Wait -NoNewWindow -PassThru
    If ($process.ExitCode -ne 0) {
        Write-Warning "Failed to install DaRT 10 please check the log at $($env:windir)\temp\MSDaRT100_Install.Log Install EXITCODE: $process.ExitCode";break
    }
    Else {
        Write-Host "DaRT 10 installed at: $ENV:ProgramFiles\$DartFolderName" -ForegroundColor Green

    }
    $DartCab = "$ENV:ProgramFiles\$DartFolderName" + "\v10\Toolsx64.cab"
    if (!(Test-Path -Path "$DartCab")) {Write-Warning "Could not find DaRT Toolsx64.cab, aborting...";Break}
}
If (Test-Path -Path $MDTDefaultPath){
    $MDTInstallationPath = $MDTDefaultPath
    }
Else {
 $MDTInstallationPath = FindFolder($MDTFolderName)
}
if (!(Test-Path -Path "$MDTInstallationPath" -ErrorAction SilentlyContinue)) {
    Write-Warning "Could not find MDT, please install MDT and re run script, aborting...";Break
    }
Else {
    Write-Host "Found MDT at: $($MDTInstallationPath)" -ForegroundColor Green 
}
if (!(Test-Path -Path "$EnableDart")) {Write-Warning "Could not find EnableDart.wsf, aborting...";Break}
if (!(Test-Path -Path "$XMLPath")) {Write-Warning "Could not find Unattend.xml, aborting...";Break}

Write-Host "##################################################################################" -ForegroundColor Green
Write-Host "All Pre Reqs found starting continuing..." -ForegroundColor Green
Write-Host "##################################################################################" -ForegroundColor Green

Write-Host "Updating Unattend.XML with new Event Service Location: $($EventServiceLocation)..." -ForegroundColor Green
#Update Unattend.xml with new event service location.
#Get the XML
[xml]$XML = (Get-Content $XMLPath)
#Set the base new command
$UpdateCMD = 'wscript.exe X:\Deploy\Scripts\EnableDart.wsf ','/EventService:',' /_SMSTSCurrentActionName:"Booted into WinPE"'
Write-Host "New CMD will be: $($UpdateCMD[0])$($UpdateCMD[1])$($EventServiceLocation)$($UpdateCMD[2])" -ForegroundColor Yellow
$CMD = $XML.unattend.settings.component.RunSynchronous.RunSynchronousCommand
$CMD.Path = $UpdateCMD[0] + $UpdateCMD[1] + $EventServiceLocation + $UpdateCMD[2]
try {
    $XML.Save($XMLPath)
    Write-Host "Successfully Saved new command line to XML: $($UpdateCMD[0])$($UpdateCMD[1])$($EventServiceLocation)$($UpdateCMD[2])"-ForegroundColor Green
}
Catch [System.Exception]{
    Write-Warning "Failed to Save new command line: '$($UpdateCMD[0])$($UpdateCMD[1])$($EventServiceLocation)$($UpdateCMD[2])' Error Message: '$($_.Exception.Message)' aborting..."
    Break;
}

# Mount the boot image
Mount-WindowsImage -ImagePath $BootImagePath -Index 1 -Path $MountPath  

# Add the needed files to the boot image
expand.exe $DartCab -F:* $MountPath
Remove-Item $MountPath\etfsboot.com -Force
Copy-Item $MDTInstallationPath\DartConfig8.dat $MountPath\Windows\System32\DartConfig.dat


if (!(Test-Path -Path "$MountPath\Deploy\Scripts")) {New-Item -ItemType directory $MountPath\Deploy\Scripts}
if (!(Test-Path -Path "$MountPath\Deploy\Scripts\x64")) {New-Item -ItemType directory $MountPath\Deploy\Scripts\x64}
Copy-Item $EnableDart $MountPath\Deploy\Scripts
Copy-Item $XMLPath $MountPath
Copy-Item "$MDTInstallationPath\Distribution\Scripts\ZTIDataAccess.vbs" $MountPath\Deploy\Scripts
Copy-Item "$MDTInstallationPath\Distribution\Scripts\ZTIUtility.vbs" $MountPath\Deploy\Scripts
Copy-Item "$MDTInstallationPath\Distribution\Scripts\ZTIGather.wsf" $MountPath\Deploy\Scripts
Copy-Item "$MDTInstallationPath\Distribution\Scripts\ZTIGather.xml" $MountPath\Deploy\Scripts
Copy-Item "$MDTInstallationPath\Distribution\Scripts\ztiRunCommandHidden.wsf" $MountPath\Deploy\Scripts
Copy-Item "$MDTInstallationPath\Distribution\Scripts\ZTIDiskUtility.vbs" $MountPath\Deploy\Scripts
Copy-Item "$MDTInstallationPath\Distribution\Tools\x64\Microsoft.BDD.Utility.dll" $MountPath\Deploy\Scripts\x64

# Save changes to the boot image
Dismount-WindowsImage -Path $MountPath -Save
Start-Sleep -Seconds 2
#Cleanup Mount folder
Remove-Item -Path $MountPath -ErrorAction SilentlyContinue -Force

# Update the boot image in ConfigMgr
Set-Location "$($SiteCode):\" 
$GetDistributionStatus = $BootImage | Get-CMDistributionStatus
$OriginalUpdateDate = $GetDistributionStatus.LastUpdateDate
Write-Host "Updating distribution points for the boot image..." -ForegroundColor Yellow
Write-Host "Last update date was: $OriginalUpdateDate" -ForegroundColor Yellow
$BootImage | Update-CMDistributionPoint

# Wait until distribution is done
Write-Output ""
Write-Output "Waiting for distribution status to update..."

Do { 
$GetDistributionStatus = $BootImage | Get-CMDistributionStatus
$NewUpdateDate = $GetDistributionStatus.LastUpdateDate
 if ($NewUpdateDate -gt $OriginalUpdateDate) {
  Write-Output ""
  Write-Host "Yay, boot image distribution status updated. New update date is: $NewUpdateDate" -ForegroundColor Green
  Write-Host "Happy Deployment!" -ForegroundColor Green
 } else {
  Write-Host "Boot image distribution status not yet updated, waiting 10 more seconds"  -ForegroundColor Cyan
 }
 Start-Sleep -Seconds 10
}
Until ($NewUpdateDate -gt $OriginalUpdateDate)
############################################################# Done :)

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

##################################################################################################################

# Original Author: Johan Arwidmark <https://deploymentresearch.com/Research/Post/670/Adding-DaRT-to-ConfigMgr-Boot-Images-And-starting-it-earlier-than-early>

# Updated By: Richie Schuster - C5 Alliance - SCCMOG.com

# Date: 28/07/2018

# 03/08/2018 - Changed Folder search to get volume and select on data drives only as found issue on VMware VMs

# Added default paths for installs MDT and Dart to speed up script for multiple Images.

# Script: Add-DartToBootImageV2.ps1

# Usage: Powershell.exe -ExecutionPolicy Bypass -File .\Add-DartToBootImageV2.ps1 -EventServiceLocation http://roary-cm-01.roary.local:9800 -BootImageName 'MDT 8450 x64' -MountDrive J -SiteServer ROARY-CM-01.ROARY.LOCAL -SiteCode ROR

##################################################################################################################

param(

[parameter(Mandatory=$true, HelpMessage="Please enter the FQDN and PortNumber of the Server that host the MDT Monitoring Service. E.g http://roary-cm-01.roary.local:9800")]

[ValidateNotNullOrEmpty()]

[string]$EventServiceLocation,

[parameter(Mandatory=$true, HelpMessage="Please enter the name of the bootimage you would like to inject DaRT into.")]

[ValidateNotNullOrEmpty()]

[string]$BootImageName,

[parameter(Mandatory=$true, HelpMessage="Please select the Mount Drive i.e <J>")]

[ValidateNotNullOrEmpty()]

[string]$MountDrive,

[parameter(Mandatory=$true, HelpMessage="Please enter the FQDN of your Site Server")]

[ValidateNotNullOrEmpty()]

[string]$SiteServer,

[parameter(Mandatory=$true, HelpMessage="Please enter you Site Code.")]

[ValidateNotNullOrEmpty()]

[string]$SiteCode

)

# Check for elevation

Write-Host "Checking for elevation"

If (-NOT ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole(`

[Security.Principal.WindowsBuiltInRole] "Administrator"))

{

Write-Warning "Oupps, you need to run this script from an elevated PowerShell prompt!`nPlease start the PowerShell prompt as an Administrator and re-run the script."

Write-Warning "Aborting script..."

Break

}

# Connect to ConfigMgr

if((Get-Module ConfigurationManager) -eq $null) {

Import-Module "$($ENV:SMS_ADMIN_UI_PATH)\..\ConfigurationManager.psd1"

}

if((Get-PSDrive -Name $SiteCode -PSProvider CMSite -ErrorAction SilentlyContinue) -eq $null) {

New-PSDrive -Name $SiteCode -PSProvider CMSite -Root $SiteServer

}

Set-Location "$($SiteCode):\"

# Get Boot image from ConfigMgr

$BootImage = Get-CMBootImage -Name $BootImageName

$BootImagePath = $BootImage.ImagePath

$XMLPath = "$PSScriptRoot\Unattend.xml"

$EnableDart = "$PSScriptRoot\EnableDart.wsf"

$SampleFiles = "$PSScriptroot"

$MountPath = "$($MountDrive):\DartMount"

$MDTDefaultPath = "C:\Program Files\Microsoft Deployment Toolkit\Templates"

$MDTFolderName = "Microsoft Deployment Toolkit\Templates"

$REGUninstall = "HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall"

$DartDefaultPath = "C:\Program Files\Microsoft DaRT"

$DartDispName = 'Microsoft Dart 10'

$DartFolderName = "Microsoft DaRT"

$DartMSI = "$PSScriptroot\MSDaRT100.msi"

#Function to find folders

Function FindFolder($FolderName){

#$Drives = Get-PSDrive -p FileSystem | Select-Object -ExpandProperty Name

$Drives = Get-Volume | Where-Object { ($_.FileSystemLabel -ne "System Reserved") -and ( $_.DriveType -like "Fixed") -and ( $_.FileSystem -like "NTFS")} | Select-Object -ExpandProperty DriveLetter | Sort-Object

$InstallPath = $null

:findfolder Foreach ($drive in $Drives) {

If ($InstallPath -eq $null) {

$Counter++

Write-host "Searching drive $($drive):\ for folder: '$($FolderName)' Drive count is $($Counter) out of $($Drives.Count)" -ForegroundColor Yellow

$InstallPath = Get-ChildItem -Recurse -Force "$($drive):\" -ErrorAction SilentlyContinue | Where-Object { ($_.PSIsContainer -eq $true) -and ( $_.FullName -like "*$FolderName") } | Select-Object -ExpandProperty FullName

}

Else {

Write-Host "Found folder at: $($InstallPath)" -ForegroundColor Green

return $InstallPath

break findfolder

}

#Write-Warning "Could not find the install Folder $Foldername exiting";break

$InstallPath = "NotFound"

return $InstallPath

}

# Check for PRE Reqs

Set-Location C:

if (!(Test-Path -Path "$XMLPath")) {Write-Warning "Could not find Unattend.xml path, check it is in script root and retry. aborting...";Break}

if (!(Test-Path -Path "$BootImagePath")) {Write-Warning "Could not find boot image, aborting...";Break}

if (!(Test-Path -Path "$DartMSI")) {Write-Warning "Could not DaRT MSI, Please place MSDaRT100.msi in script root folder, aborting...";Break}

if (!(Test-Path -Path "$MountPath")) {

Write-Warning "Could not find mount path, Creating..."

try {

New-item -Path "$MountPath" -ItemType Directory -ErrorAction SilentlyContinue -Force

Write-Host "Successfully Created Mount Path at: $($MountPath)" -ForegroundColor Green

}

catch [System.Exception]{

Write-Host "Failed to create Mount Path at: $($MountPath) Error Message: $($_.Exception.Message)";Break

}

#Check if dart is installed - If not install it.

$DaRT10 = Get-ItemProperty "$REGUninstall\*" | Where-Object DisplayName -Like $DartDispName

if($DaRT10.VersionMajor -eq “10”){

Write-Host "Dart is installed searching for CAB file location"

If (Test-Path -Path $DartDefaultPath){

$DartInstallPath = $DartDefaultPath

}

Else {

$DartInstallPath = FindFolder($DartFolderName)

}

$DartCab = $DartInstallPath + "\v10\Toolsx64.cab"

if (Test-Path -Path "$DartCab"){

Write-Host "Found DaRT x64 CAB at: $($DartCab)" -ForegroundColor Green

}

else {

Write-Warning "Could not find DaRT 10 Toolsx64.cab, Please remove older version of DaRT and retry. aborting...";

Break

}

else{

Write-Warning "Could not find any DaRT version installed. Installing DaRT MSI in root of folder."

$DartArgs = "/i $DartMSI /qb /norestart /L*v $env:windir\temp\MSDaRT100_Install.Log"

$process = Start-Process -FilePath "msiexec.exe" -ArgumentList $DartArgs -Wait -NoNewWindow -PassThru

If ($process.ExitCode -ne 0) {

Write-Warning "Failed to install DaRT 10 please check the log at $($env:windir)\temp\MSDaRT100_Install.Log Install EXITCODE: $process.ExitCode";break

}

Else {

Write-Host "DaRT 10 installed at: $ENV:ProgramFiles\$DartFolderName" -ForegroundColor Green

}

$DartCab = "$ENV:ProgramFiles\$DartFolderName" + "\v10\Toolsx64.cab"

if (!(Test-Path -Path "$DartCab")) {Write-Warning "Could not find DaRT Toolsx64.cab, aborting...";Break}

}

If (Test-Path -Path $MDTDefaultPath){

$MDTInstallationPath = $MDTDefaultPath

}

Else {

$MDTInstallationPath = FindFolder($MDTFolderName)

}

if (!(Test-Path -Path "$MDTInstallationPath" -ErrorAction SilentlyContinue)) {

Write-Warning "Could not find MDT, please install MDT and re run script, aborting...";Break

}

Else {

Write-Host "Found MDT at: $($MDTInstallationPath)" -ForegroundColor Green

}

if (!(Test-Path -Path "$EnableDart")) {Write-Warning "Could not find EnableDart.wsf, aborting...";Break}

if (!(Test-Path -Path "$XMLPath")) {Write-Warning "Could not find Unattend.xml, aborting...";Break}

Write-Host "##################################################################################" -ForegroundColor Green

Write-Host "All Pre Reqs found starting continuing..." -ForegroundColor Green

Write-Host "##################################################################################" -ForegroundColor Green

Write-Host "Updating Unattend.XML with new Event Service Location: $($EventServiceLocation)..." -ForegroundColor Green

#Update Unattend.xml with new event service location.

#Get the XML

[xml]$XML = (Get-Content $XMLPath)

#Set the base new command

$UpdateCMD = 'wscript.exe X:\Deploy\Scripts\EnableDart.wsf ','/EventService:',' /_SMSTSCurrentActionName:"Booted into WinPE"'

Write-Host "New CMD will be: $($UpdateCMD[0])$($UpdateCMD[1])$($EventServiceLocation)$($UpdateCMD[2])" -ForegroundColor Yellow

$CMD = $XML.unattend.settings.component.RunSynchronous.RunSynchronousCommand

$CMD.Path = $UpdateCMD[0] + $UpdateCMD[1] + $EventServiceLocation + $UpdateCMD[2]

try {

$XML.Save($XMLPath)

Write-Host "Successfully Saved new command line to XML: $($UpdateCMD[0])$($UpdateCMD[1])$($EventServiceLocation)$($UpdateCMD[2])"-ForegroundColor Green

}

Catch [System.Exception]{

Write-Warning "Failed to Save new command line: '$($UpdateCMD[0])$($UpdateCMD[1])$($EventServiceLocation)$($UpdateCMD[2])' Error Message: '$($_.Exception.Message)' aborting..."

Break;

}

# Mount the boot image

Mount-WindowsImage -ImagePath $BootImagePath -Index 1 -Path $MountPath

# Add the needed files to the boot image

expand.exe $DartCab -F:* $MountPath

Remove-Item $MountPath\etfsboot.com -Force

Copy-Item $MDTInstallationPath\DartConfig8.dat $MountPath\Windows\System32\DartConfig.dat

if (!(Test-Path -Path "$MountPath\Deploy\Scripts")) {New-Item -ItemType directory $MountPath\Deploy\Scripts}

if (!(Test-Path -Path "$MountPath\Deploy\Scripts\x64")) {New-Item -ItemType directory $MountPath\Deploy\Scripts\x64}

Copy-Item $EnableDart $MountPath\Deploy\Scripts

Copy-Item $XMLPath $MountPath

Copy-Item "$MDTInstallationPath\Distribution\Scripts\ZTIDataAccess.vbs" $MountPath\Deploy\Scripts

Copy-Item "$MDTInstallationPath\Distribution\Scripts\ZTIUtility.vbs" $MountPath\Deploy\Scripts

Copy-Item "$MDTInstallationPath\Distribution\Scripts\ZTIGather.wsf" $MountPath\Deploy\Scripts

Copy-Item "$MDTInstallationPath\Distribution\Scripts\ZTIGather.xml" $MountPath\Deploy\Scripts

Copy-Item "$MDTInstallationPath\Distribution\Scripts\ztiRunCommandHidden.wsf" $MountPath\Deploy\Scripts

Copy-Item "$MDTInstallationPath\Distribution\Scripts\ZTIDiskUtility.vbs" $MountPath\Deploy\Scripts

Copy-Item "$MDTInstallationPath\Distribution\Tools\x64\Microsoft.BDD.Utility.dll" $MountPath\Deploy\Scripts\x64

# Save changes to the boot image

Dismount-WindowsImage -Path $MountPath -Save

Start-Sleep -Seconds 2

#Cleanup Mount folder

Remove-Item -Path $MountPath -ErrorAction SilentlyContinue -Force

# Update the boot image in ConfigMgr

Set-Location "$($SiteCode):\"

$GetDistributionStatus = $BootImage | Get-CMDistributionStatus

$OriginalUpdateDate = $GetDistributionStatus.LastUpdateDate

Write-Host "Updating distribution points for the boot image..." -ForegroundColor Yellow

Write-Host "Last update date was: $OriginalUpdateDate" -ForegroundColor Yellow

$BootImage | Update-CMDistributionPoint

# Wait until distribution is done

Write-Output ""

Write-Output "Waiting for distribution status to update..."

Do {

$GetDistributionStatus = $BootImage | Get-CMDistributionStatus

$NewUpdateDate = $GetDistributionStatus.LastUpdateDate

if ($NewUpdateDate -gt $OriginalUpdateDate) {

Write-Output ""

Write-Host "Yay, boot image distribution status updated. New update date is: $NewUpdateDate" -ForegroundColor Green

Write-Host "Happy Deployment!" -ForegroundColor Green

} else {

Write-Host "Boot image distribution status not yet updated, waiting 10 more seconds" -ForegroundColor Cyan

}

Start-Sleep -Seconds 10

}

Until ($NewUpdateDate -gt $OriginalUpdateDate)

############################################################# Done :)