Current Known Issue: With the Windows 10 1903 ADK on 64-bit, the Windows System Image Manager (WSIM) will fail to generate a catalogue. Microsoft has issued a fix which you can download here. The fix contains two updated files, ImageCat.exe and ImgMgr.exe which need to be copied to the location the ADK is installed. By default the location is: C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\WSIM. After installation you will still not be able to access the WSIM through MDT, but launching WSIM manually and then opening the install.wim file for the Operation System you wish to change, and the XML answer file which will be located in \\server\share\Control\Task-Sequence-ID\Unattend.xml. Many thanks to reader Mark Stenglein for letting me know about this in the comments!
Important note: If you are using Enterprise or Education editions of Windows 10, from 1809 onwards, the xx09 versions of Windows 10 get 30 months of support, over the usual 18 months that the xx03 versions get. So you may wish to reconsider if you deploy the xx03 version at all and just wait for the xx09 update. Here’s some official information from Microsoft here.
This post will walk through installing and configuring Microsoft Deployment Toolkit to build a reference image of Windows 10 1903 (May 2019 Update) using a Hyper-V Virtual Machine. It is assumed that you have a Server or PC ready to install MDT onto and create an file share for MDT to build the image with. I’ll focusing on the Enterprise edition of Windows 10. Here are the links to the software we’ll be using:
- Windows 10 1903 Assessment and Deployment Kit (ADK)
- Windows PE add-on for the ADK
- Microsoft Deployment Toolkit (8456)
- Windows 10 1903 x64 Volume Licensing Service Center
Additional software which may be useful to you:
- Remote Server Administration Tools for Windows 10 - Be sure to download the version of RSAT for the version of Server you want to administer.
Installing Microsoft Deployment Toolkit and Dependencies
- First we’ll install the Windows 10 1903 ADK. During setup additional files will need to be downloaded, so it may take some time depending on your internet connection.
- On the Select the features you want to install screen select:
- Deployment Tools
- Imaging And Configuration Designer (ICD)
- Configuration Designer
- User State Migration Tool (USMT)
- WinPE is now a separate install. Install the WinPE add-on by running the adkwinpesetup.exe, there is no specific configuration during the install wizard.
- Now install MDT by running the setup file downloaded earlier. There is no specific configuration during the install wizard.
Creating the Deployment Share
- Open the Deployment Workbench from the Start Menu.
- Right click on Deployment Shares.
- Select New Deployment Share.
- Enter the path for the Deployment Share: E:\Build.
- Enter the Share name: Build$.
- Give the share a description.
- On the Options screen, accept the defaults as you can change them later.
- Complete the wizard to create the share.
- By default, the share permissions are set the local administrators group. We’ll revisit this later.
Adding an Operating System
- Mount the Windows 10 1903 ISO in File Explorer.
- Go to Deployment Workbench > Operating Systems.
- Right click and select New Folder.
- Enter the name Windows 10 1903 x64 and click through the wizard to create the folder.
- Right click again and select Import Operating System.
- In the wizard, select Full set of source files and then enter the root of the mounted ISO as the Source directory.
- For the destination directory name enter Windows 10 1903 x64 and complete the wizard.
- Go to the Operating Systems/Windows 10 1903 x64 node and rename the new entries added to Windows 10 1903 Edition x64 for ease of use.
Creating Package Folder For Future Updates
- Go to Deployment Workbench > Packages.
- Create a folder named Windows 10 1903 x64.
Now we’ll create a selection profile so that the Task Sequence only attempts to install the updates for Windows 10 1903 x64.
Creating A Selection Profile
- Expand the Advanced Configuration node.
- Right click on Selection Profiles and select New Selection Profile.
- Name it Windows 10 1903 x64.
- On the Folders page, tick the Windows 10 1903 x64 folder under Packages and complete the wizard.
If you want to add some applications to be a part of your reference image, here I’ll cover how to add Microsoft Office. MDT recognises Microsoft Office and provides automated/silent install options.
- Go to Deployment Workbench > Deployment Share > Applications.
- Right click on Applications and select New Application.
- In the New Application Wizard, choose Application with source files.
- Give the application the name: Microsoft Office.
- Enter the Source directory of the installation files.
- Enter the Destination directory: Microsoft Office.
- For the Command line enter anything, we’ll revisit this later.
- On the summary page, click Next and after the files are copied click Finish to complete the wizard.
- Right click on Microsoft Office, go to the Office Products Tab.
- Choose the desired Office Product to Install from the drop down menu.
- Check the desired Office language.
- Enter a product key, unless you will be activating Office via KMS in which case leave the Product Key option unchecked.
- Check the Customer name option and enter the desired information.
- Check the Display level option and select None in the drop down menu.
- Check the Accept EULA option.
- Check the Always suppress reboot option.
- Click Apply.
- Go to the Details tab and the Quiet install command should now read:
setup.exe /config proplus.ww\config.xml
Microsoft Office is now set up to be installed silently by a Task Sequence. If you wish to customise the installation to a greater degree, the Office Customization Tool can be launched from the Office Products tab. This process can also be done for Microsoft Visio and Project. To add other popular third party software, you’ll need to repeat the steps above, with the relevant Command line to quietly or silently install them.
msiexec /I googlechromestandaloneenterprise64.msi /qn
We now need to create a new Task Sequence to create a reference image.
Creating a Task Sequence
- In Deployment Workbench, go to Task Sequences.
- Right click and select New Task Sequence.
- For the ID enter: W10-1903.
- Name it Build Windows 10 1903.
- Select Standard Client Task Sequence.
- Select the Operating System Windows 10 1903 x64.
- Select Do not specify a product key at this time.
- Enter an Organization name.
- Select Do not specify an Administrator password at this time.
- Complete the wizard.
Now we’ll configure the Task Sequence.
Configuring the Task Sequence
- Right click on the Task Sequence just created and select Properties.
- Go to the Task Sequence tab on the Properties window of the Task Sequence.
- Expand the Preinstall folder, and select the Apply Patches item.
- Change the Selection Profile to Windows 10 1903 x64.
- Go to the State Restore folder and select Windows Update (Pre-Application Installation).
- On the right side of the Properties window, go to the Options tab.
- Uncheck the Disable this step tick box and do the same with Windows Update (Post-Application Installation).
- If you skipped the Importing Applications section, please disable the Install Applications item and go to step 16, if not please continue.
- Go to the Install Applications item.
- In the right side of the Properties box, select the Install a single application option and click the Browse… button.
- Select Microsoft Office and change the name Install Applications to Microsoft Office.
- Install other Applications, copy and paste the Install Applications item and repeat steps 13 - 15 for the applications of your choice.
- Click Apply and close the Task Sequence.
Blocking Internet Access to prevent Microsoft Store App Updates
To block internet access to the VM whilst the image is building, we’ll use the script from Peter Löfgren’s System Center Ramblings post.
- First create a PowerShell script file called Internet-Access.ps1 with the following code:
- Save the script in your MDT share, where the Task Sequence will be able to access it. I save my custom scripts in a folder called _scripts the Applications folder.
- In the Task Sequence created above, we’ll add the items required to run the PowerShell script to enable and disable the internet blocking firewall rules.
- Go to the Task Sequence tab on the Properties window of the Task Sequence.
- Go to State Restore and click on the Add button.
- Go to General > Run PowerShell Script.
- Name the new item PS Script - Disable Internet Access.
- Enter Z:\Applications\_scripts\Internet-Access.ps1 or your own path to the PowerShell script we just created.
- Scroll down the Task Sequence to just above the Imaging folder.
- Once again, add a new Run PowerShell Script item.
- Name it PS Script - Enable Internet Access.
- Again, enter Z:\Applications\_scripts\Internet-Access.ps1 or or your own path to the PowerShell script.
- Important: Add -Disable to the Parameters section.
- Click Apply and OK to close the Task Sequence.
What will happen now is that after Windows boots up, a firewall rule will be added to block internet traffic on ports 80 and 443, and just before starting the SysPrep and capture process the firewall rule will be removed. Next, we’ll create a domain user account for MDT.
Creating a service account for MDT in Active Directory
- Go to Active Directory Users and Computers.
- Create a user called mdt_admin and give it a complex password.
- Go to the Server or PC where the Deployment Share is hosted.
- Give the user mdt_admin Full Control share permissions and Full Control permissions to all the files and folders in the Deployment Share.
Next we need to configure the Bootstrap.ini and the CustomSettings.ini files to control certain aspects of the deployment environment. The settings below enable auto log in and skip the welcome screen, so these should only be used for lab or closed development environments.
- In Deployment Workbench, right click the Deployment Share and select Properties.
- Select the Rules tab and click the Edit Bootstrap.ini button.
- Add the settings below to the Bootstrap.ini.
- Close and Save the Bootstrap.ini
On the Rules tab of the Deployment Share properties window, add the settings below.
We now need to create the boot media to boot the VM into the deployment environment.
Creating The Boot Media
- In Deployment Workbench, right click on the Deployment Share.
- Select Update Deployment Share.
- Select Completely regenerate the boot images.
- Complete the wizard. It will take some time to create the boot images.
Testing and Capturing a Reference Image
To test everything we need to copy the ISO file that we just generated. It is located in the Boot folder in the Deployment Share. Go to the Server or PC that is hosting the deployment share and navigate to the boot folder. Inside there should be a file named LiteTouchPE_x64.iso. Copy this file to a location where a Hyper-V Virtual Machine will be able to access it. Create a new VM in Hyper-V with the following configuration:
- 2x vCPUs
- 4GB of RAM
- Network Adapter with access the local network.
- Virtual Hard Drive of at least 40GB, preferably on an SSD.
- Boot from CD using the LiteTouchPE_x64.iso from MDT.
- If using Hyper-V on Windows 10 1709 and above, make sure Use Automatic Checkpoints is disabled.
Start the VM and it will boot from the LiteTouchPE_x64.iso into the deployment environment. You will be presented with a screen with the name of the Task Sequence you created earlier. Select your Task Sequence and click Next and the task sequence will begin. The Task Sequence will install Windows 10 1903, update from the WSUS server, install the optional applications if you added them, and then run Windows Update from the WSUS server again. It will then run SysPrep and the reboot back into the deployment environment and MDT will capture the image. When this process completes the VM will be shutdown and a file named W10-1903_YEAR_MONTH_DAY_HOUR_MINUTE.wim will be in the Captures folder in the Deployment Share.
You now have a reference image for Windows 10 1903 and a Microsoft Deployment Toolkit installation, with a deployment share specifically configured for building reference images. We’ll cover setting up a deployment share and focus on tasks to support deploying Windows to real hardware in this article.