Skip to content

Commit a96f2cc

Browse files
34496511 - 2601: (OOB) Update Win32 app management documentation to include PowerShell script installer details
1 parent 61bb614 commit a96f2cc

2 files changed

Lines changed: 48 additions & 3 deletions

File tree

intune/intune-service/apps/apps-win32-add.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Add and Assign Win32 Apps to Microsoft Intune
33
description: Learn how to add, assign, and manage Win32 apps with Microsoft Intune.
4-
ms.date: 10/02/2025
4+
ms.date: 01/14/2026
55
ms.topic: how-to
66
ms.reviewer: bryanke
77
ms.collection:
@@ -82,7 +82,13 @@ Select **Next** to display the **Program** page.
8282

8383
On the **Program** page, configure the app installation and removal commands for the app:
8484

85-
- **Install command**: Add the complete installation command line to install the app.
85+
- **Install command**: Configure how the app is installed on devices.
86+
87+
**Installer type**: Choose between two options:
88+
- **Command line**: Specify a command line to install the app
89+
- **PowerShell script**: Upload a PowerShell script to serve as the installer
90+
91+
For command line installations, add the complete installation command line to install the app.
8692

8793
For example, if your app's file name is **MyApp123**, add the following:
8894

@@ -96,6 +102,11 @@ On the **Program** page, configure the app installation and removal commands for
96102

97103
For the specific arguments that the application package supports, contact your application vendor.
98104

105+
For PowerShell script installations, select **PowerShell script** to upload your install script (maximum size 50 KB). The script replaces the standard install command and enables richer setup workflows like prerequisite checks, configuration changes, and post-install actions. Intune packages the script with the app content and runs it in the same context as the app installer. Installation results appear in the Intune admin center based on the script's return code.
106+
107+
> [!NOTE]
108+
> If Multi-Admin Approval (MAA) is enabled for your tenant, you can't upload PowerShell scripts during app creation. You must first create the app, then add or modify scripts afterward. Currently, script properties like `enforceSignatureCheck` and `runAs32Bit` can be edited without MAA requests, but this behavior will change in a future update to require MAA approval.
109+
99110
> [!IMPORTANT]
100111
> Admins must be careful when they use the command tools. Unexpected or harmful commands might be passed via the **Install command** and **Uninstall command** fields.
101112
>

intune/intune-service/apps/apps-win32-app-management.md

Lines changed: 35 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Win32 App Management in Microsoft Intune
33
description: Learn how to manage Win32 apps with Microsoft Intune. This article provides an overview of the Intune Win32 app delivery and management capabilities.
4-
ms.date: 10/02/2025
4+
ms.date: 01/14/2026
55
ms.topic: overview
66
ms.reviewer: bryanke
77
ai-usage: ai-assisted
@@ -48,6 +48,40 @@ To use Win32 app management, be sure the following criteria are met:
4848
>
4949
> The [Microsoft Intune management extension (IME)](../apps/intune-management-extension.md) provides Intune's Win32 app type capabilities on managed clients. It's installed automatically when a PowerShell script or Win32 app is assigned to the user or device. Additionally, the Intune management extension agent checks every hour (or on service or device restart) for any new Win32 app assignments.
5050
51+
## PowerShell script installer
52+
53+
When adding a Win32 app, you can upload a PowerShell script to serve as the installer instead of specifying a command line. Intune packages the script with the app content and runs it in the same context as the app installer. This capability enables richer setup workflows, including:
54+
55+
- Prerequisite checks before installation
56+
- Configuration changes during installation
57+
- Post-install actions and validation
58+
- Complex conditional logic based on device state
59+
60+
The PowerShell script runs in place of the standard install command, and installation results appear in the Intune admin center based on the script's return code.
61+
62+
### Script requirements
63+
64+
- Scripts are limited to 50 KB in size
65+
- Scripts run in the same context as the app installer (system or user context)
66+
- Return codes from the script determine installation success or failure status
67+
- Scripts should run silently without user interaction
68+
69+
> [!NOTE]
70+
> If Multi-Admin Approval (MAA) is enabled for your tenant, you can't upload PowerShell scripts during app creation. You must first create the app, then add or modify scripts afterward. Currently, script properties like `enforceSignatureCheck` and `runAs32Bit` can be edited without MAA requests, but this behavior will change in a future update to require MAA approval.
71+
72+
### When to use script installers
73+
74+
Consider using PowerShell script installers when:
75+
76+
- Your app requires prerequisite validation before installation
77+
- You need to perform configuration changes alongside app installation
78+
- The installation process requires conditional logic
79+
- Post-installation actions are needed (like registry modifications or service configuration)
80+
81+
For command line installations, you can continue using the traditional Install command field.
82+
83+
For more information about adding Win32 apps with script installers, see [Add, assign, and monitor a Win32 app in Microsoft Intune](../apps/apps-win32-add.md).
84+
5185
## Prepare the Win32 app content for upload
5286

5387
Before you can add a Win32 app to Microsoft Intune, you must prepare the app by using the Microsoft Win32 Content Prep Tool. You use the Microsoft Win32 Content Prep Tool to preprocess Windows classic (Win32) apps. The tool converts application installation files into the *.intunewin* format. For more information and steps, see [Prepare Win32 app content for upload](apps-win32-prepare.md).

0 commit comments

Comments
 (0)