Skip to main content
Version: 4.0

How to Deploy

There are two ways to launch the PSAppDeployToolkit for deployment of applications.

  • Launch Invoke-AppDeployToolkit.ps1 PowerShell script as administrator.
  • Launch Invoke-AppDeployToolkit.exe as administrator. This will launch the Invoke-AppDeployToolkit.ps1 PowerShell script without opening a PowerShell command window.

Additionally:

  • If deploying a system-wide app via Configuration Manager, the 'Allow users to view and interact with the program installation' option should be enabled on the Deployment Type in order to display the UI.
  • If deploying a system-wide app via Intune, no such option is available. It is recommended to use ServiceUI.exe to make the deployment process visible to the user using this helper script: Invoke-ServiceUI.ps1
  • If PowerShell x86 is required (for example, if CAPICOM or another x86 library is needed), launch with Invoke-AppDeployToolkit.exe /32.

Deploy an application for installation

Invoke-AppDeployToolkit.ps1

Deploy an application for uninstallation in silent mode

Invoke-AppDeployToolkit.ps1 -DeploymentType Uninstall -DeployMode Silent

Deploy an application for uninstallation using PowerShell x86, suppressing the PowerShell console window and deploying in silent mode.

Invoke-AppDeployToolkit.exe /32 -DeploymentType Uninstall -DeployMode Silent

Deploy an application for installation, suppressing the PowerShell console window and allowing reboot codes to be returned to the parent process.

Invoke-AppDeployToolkit.exe -AllowRebootPassThru

Deploy an application with a custom name instead of Invoke-AppDeployToolkit.ps1.

Invoke-AppDeployToolkit.exe Custom-Script.ps1

Remove an application with a custom name and custom location for the script file.

Invoke-AppDeployToolkit.exe -Command C:\Testing\Custom-Script.ps1 -DeploymentType Uninstall

Toolkit Parameters

The following parameters are accepted by Invoke-AppDeployToolkit.ps1:

-DeploymentType

Specify whether to install or uninstall the application.

-DeploymentType Install ## default
-DeploymentType Uninstall
-DeployMode

Specify the installation will be run in Interactive, Silent or NonInteractive mode:

  • Interactive = Shows dialogs
  • NonInteractive = Passive install, only shows dialogs that do not expect a response from the user (i.e. progress dialogs).
  • Silent = No dialogs (progress and prompts are suppressed)
-DeployMode Interactive ## default
-DeployMode Silent
-DeployMode NonInteractive
-AllowRebootPassthru

Specify whether to allow the 3010 exit code (reboot required) to be passed back to the parent process (e.g. Microsoft Configuration Manager or Intune) at the end of installation. If a 3010 code is passed, the ConfigMgr client / Intune Management Engine may display a reboot prompt. If set to false, the 3010 return code will be replaced by a "0" (successful, no restart required).

-AllowRebootPassThru
-TerminalServerMode

Changes to user install mode and back to user execute mode for installing/uninstalling applications on Remote Desktop Session Host/Citrix servers

-TerminalServerMode
-DisableLogging

Disables logging to file for the script.

-DisableLogging

This is a switch parameter, so setting this enables it. When not present, the default is false.