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 theInvoke-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.