Deploying an MSU (Microsoft Update Standalone Package) file through Intune involves converting it into a Win32 application and then configuring its deployment in the Microsoft Intune admin center. This method allows for silent, managed installation of critical updates, hotfixes, or feature packs across your organization's Windows devices.
What is an MSU File?
An MSU file is a self-contained package that installs Windows updates. These files are commonly downloaded from the Microsoft Update Catalog and contain updates that might not be available through standard Windows Update channels or are needed for offline installation.
Key Steps to Deploy an MSU File via Intune
To successfully deploy an MSU file using Intune, you'll follow a four-stage process:
- Obtain the MSU File: Download the necessary update package from a reliable source.
- Prepare for Intune: Convert the MSU file into the
.intunewin
format using the Microsoft Win32 Content Prep Tool. - Upload and Configure in Intune: Add the
.intunewin
application to the Intune admin center and define its installation parameters, requirements, and detection rules. - Assign the Application: Distribute the application to your target user or device groups.
Step 1: Obtain the MSU File
The first step is to download the specific Windows update package you intend to deploy.
- Microsoft Update Catalog: Navigate to the Microsoft Update Catalog.
- Search: Use the search bar to find the specific update you need by its KB number (e.g., "KB5005033") or a description (e.g., "Windows 10 21H2 cumulative update").
- Download: Once you locate the correct update for your target architecture (x64, x86, ARM64) and Windows version, click the Download button. This will provide you with the
.msu
file.
Step 2: Prepare the MSU for Intune (Win32 App Packaging)
Intune requires applications to be packaged in the .intunewin
format for Win32 app deployment. You'll use the Microsoft Win32 Content Prep Tool for this conversion.
Download the Win32 Content Prep Tool
- Download the tool from its GitHub repository.
Convert the .msu
File to .intunewin
-
Create a Source Folder: Place your downloaded
.msu
file into a dedicated source folder (e.g.,C:\IntuneApp\Source
). This folder should contain only the MSU file and any other necessary support files. -
Create an Output Folder: Create an empty folder where the
.intunewin
file will be generated (e.g.,C:\IntuneApp\Output
). -
Run the Tool: Open an elevated PowerShell or Command Prompt window, navigate to the directory where you saved the
IntuneWinAppUtil.exe
tool, and run it..\IntuneWinAppUtil.exe
-
Follow the Prompts: The tool will guide you through the process:
- Source Folder: Enter the path to your source folder (e.g.,
C:\IntuneApp\Source
). - Setup File: Enter the name of your MSU file (e.g.,
windows10.0-kb1234567-x64.msu
). - Output Folder: Enter the path to your output folder (e.g.,
C:\IntuneApp\Output
). - Catalog File: When prompted "Do you want to specify a catalog folder?", type
N
(for No) unless you have a specific reason to include one.
The tool will then convert the
.msu
file into an.intunewin
package in your specified output folder. - Source Folder: Enter the path to your source folder (e.g.,
Step 3: Upload and Configure the Win32 App in Intune
Now that you have your .intunewin
package, you can upload it to Intune and configure its deployment settings.
-
Access Intune Admin Center: Go to the Microsoft Intune admin center.
-
Navigate to Apps: Select Apps > All apps > + Add.
-
Select App Type: Under "Other app types," choose Windows app (Win32) and click Select.
-
App Package File:
- Click Select app package file.
- Click the folder icon and browse to your generated
.intunewin
file. - Click OK.
-
App Information:
- Name: Provide a descriptive name (e.g., "Windows 10 22H2 KB1234567 Cumulative Update").
- Description: Briefly explain the update's purpose.
- Publisher: Microsoft
- Category: (Optional) Select an appropriate category.
- Show this as a featured app in the Company Portal: (Optional) Set to No for updates.
- Logo: (Optional) Upload a logo.
- Click Next.
-
Program: This is where you define how the MSU file will be installed.
Setting Value Example Explanation Install command wusa.exe "windows10.0-kb1234567-x64.msu" /quiet /norestart
wusa.exe
is the Windows Update Standalone Installer./quiet
ensures silent installation./norestart
prevents an immediate reboot.Uninstall command wusa.exe /uninstall /kb:1234567 /quiet /norestart
To uninstall, specify the KB number. Note that not all MSU files can be easily uninstalled, and some might require a restart. Install behavior System
Most updates should install in the system context. Device restart behavior No specific action
Recommended with /norestart
. You can configure a separate Intune restart policy if a reboot is desired later.Specify post-installation restart behavior Determine behavior based on return codes
This is generally the best option, allowing the update to dictate if a restart is needed. Return codes (Default values are usually sufficient) 0 (Success), 1707 (Success), 3010 (Success on restart), 1641 (Hard reboot needed) Click Next.
-
Requirements: Define the operating system and architecture for the update.
- Operating system architecture: Select
64-bit
or32-bit
as appropriate for your MSU. - Minimum operating system: Select the minimum Windows version required (e.g.,
Windows 10 21H2
). - Click Next.
- Operating system architecture: Select
-
Detection Rules: This is critical for Intune to determine if the application has been successfully installed on the device.
- Rules format: Select
Manually configure detection rules
. - + Add: Click to add a rule.
- Rule type: Select
MSI
if the MSU update registers as an MSI package (less common), orFile
orRegistry
which are more robust for MSU files.
Example Detection Rule (Registry Key)
Most MSU updates will create or modify a registry key. A common place to check is the
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\Packages
hive.- Rule type:
Registry
- Key path:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\Packages
- Value name:
Package_for_RollupFix~31bf3856ad364e35~amd64~~19041.1234.1.5
(This is an example; the exact value will vary by KB. You can find this by installing the MSU on a test machine and then checking the registry.) - Detection method:
Key exists
orString comparison
if you know a specific value it sets. - Click OK and then Next.
- Rules format: Select
-
Dependencies: (Optional) If your MSU has prerequisites, define them here. Click Next.
-
Supersedence: (Optional) If this update supersedes an older one, configure it here. Click Next.
-
Assignments: Assign the application to the appropriate user or device groups.
- Required: The app will automatically install on devices in the selected groups.
- Available for enrolled devices: Users can install the app from the Company Portal.
- Uninstall: The app will be uninstalled from devices in the selected groups.
For updates, Required is typically used.
Click Next. -
Review + create: Review all your settings and click Create to add the application to Intune.
Step 4: Assign the Application
After creating the application, ensure it's assigned to the correct groups for deployment. If you already did this in Step 11, you're all set. Otherwise:
- From the Apps > All apps list, select your newly created MSU application.
- Go to Properties > Assignments > Edit.
- Add the desired groups under Required, Available for enrolled devices, or Uninstall, then Review + save.
Practical Insights and Troubleshooting
- Test Locally: Before packaging, test your
wusa.exe
install command on a local test machine to ensure it runs silently and successfully. - Detection Rule Accuracy: The accuracy of your detection rule is paramount. If Intune cannot detect the app, it will continuously try to reinstall it. Spend time verifying the registry key or file path on a test machine after a successful manual installation.
- Log Files: For troubleshooting Win32 app deployments, check the
IntuneManagementExtension.log
file located atC:\ProgramData\Microsoft\IntuneManagementExtension\Logs
on the client device. This log provides detailed information on the download, execution, and detection of your Win32 app. - Restart Behavior: Decide carefully how you want to handle reboots. While
/norestart
prevents immediate reboots, many updates require a reboot to fully apply. Consider using Intune's built-in device restart experience or a separate script to prompt users for a restart after a successful update installation. - Deployment Monitoring: Monitor the deployment status in the Intune admin center under Apps > All apps > [Your App Name] > Device install status or User install status to track progress and identify any failures.
By following these steps, you can effectively deploy MSU files to your Windows devices using Microsoft Intune, ensuring your systems are kept up-to-date and secure.