Export (0) Print
Expand All

Deploy apps to computers in Microsoft Intune

 

Updated: August 1, 2015

Applies To: Microsoft Intune

The information in this topic leads you through the steps to deploy apps to managed computers by using Microsoft Intune.

Make sure that you have app files available and that they meet specific requirements before you publish software installer files to Microsoft Intune cloud storage. Consider the following:

  • The installer files that are required for the app must exist in a storage location that Intune can access and all associated files must be in the same location.

  • If the Setup file is an executable program (.exe) file, the wizard might not be able to extract information about the file.

  • Make sure no single file size is larger than 2 GB.

  • Verify that you have a minimum Internet speed of 768 kbps.

  • For available installations, make sure that managed users are linked to their computers. Otherwise, users cannot view the external link or download the available app from the Microsoft Intune company portal to that computer. For details, see How to manage user-device linking.

  • Test silent installation switches. Windows Installer files that you deploy must support silent installation, that is, without requiring user intervention. If your app uses any other type of Setup file, or requires user interaction during setup, that app cannot be installed by using Intune. The methods that are available to configure a silent installation for apps vary. Therefore, test the app deployment before rolling it out to your users. To help in this testing, you can create a test deployment group that contains computers (or virtual machines) that represent operating systems and configurations that you support in the Intune environment. You can then deploy to this group first, monitor the status of the installation, and check for any issues that might arise, before your users are exposed to them.

    In most cases, Windows Installer (.msi) and Windows Installer Patch (.msp) files do not require any command-line arguments to be installed by Intune. Check your app documentation. If command-line arguments are required, they must be entered as Name=Value pairs (such as TRANSFORMS=custom_transform.mst).

You must publish installers or external links to Intune cloud storage before you can deploy the app to users.

To publish apps as an external link

  1. In the Microsoft Intune administrator console, click Apps > Apps > Add App. If prompted, enter your Intune credentials.

    System_CAPS_noteNote

    When you start the Microsoft Intune Software Publisher for the first time, a short delay occurs while the app is installed.

  2. On the Before you begin page, click Next.

  3. On the setup page, select External link in Select how this is made available to devices.

  4. Enter the external link for the app in Specify the URL, and then click Next. Before you publish the external link, be sure to test the URL from the default Internet browser of a target mobile device.

  5. On the description page, provide the information that you want users to see in the company portal for the app, and then click Next. The following settings are available:

    Setting

    Details

    Publisher

    Enter the name of the publisher. For example, Microsoft or Contoso.

    Name

    Enter or change the name of the app. The app name is displayed in the company portal. It is also used when you search for apps. Each app package should have a unique name. If the company portal detects multiple apps with the same name, it will only display one of the apps.

    Description

    Enter a description for the app. The description is displayed in the company portal.

    Category

    Select the category that best fits the app. Use Other Apps for an app that does not match the predefined categories. The category that you select is used to classify the app. This setting is optional.

    Display this as a featured app and highlight it in the company portal

    Select this option to display the app prominently in the company portal on devices.

    Icon

    Choose whether to associate an icon with the app. The maximum size for the icon is 250 x 250 pixels. The recommended size is 32 x 32 pixels. This setting is optional.

  6. On the Summary page, verify the app information, and then click Upload. Click Close to exit the wizard.

The app is ready to be deployed after you publish it to Intune cloud storage. Consider the following:

  • Cloud storage: Uploaded apps are stored in Intune cloud storage that your organization purchased. If you have insufficient free space to upload the app package, you are notified of this during the upload process. Intune cannot determine whether there is enough free space until after the app upload has started. For details, see Cloud storage requirements.

  • License agreements: The app is ready to be deployed after you publish it to Intune. Before you deploy the app, make sure you have the appropriate licenses for the app. For details, see Manage license agreements for computer software in Microsoft Intune.

To publish an installer for computers

  1. In the Microsoft Intune administrator console, click Apps > Apps > Add App. If prompted, enter your Intune credentials.

    System_CAPS_noteNote

    When you start the Microsoft Intune Software Publisher for the first time, a short delay occurs while the app is installed.

  2. On the Before you begin page, click Next.

  3. On the Software setup page, select installer in Select how this software is made available to devices.

  4. Enter the full path to the app installation file in Specify the location of the software setup files or browse to its location.

  5. Click Include additional files and subfolders from the same folder, if additional files and subfolders are required for the installation.

  6. Click Next. Based on the setup file you specify, Microsoft Intune Software Publisher attempts to automatically extract information to use in the name and description fields on the Software description page.

  7. On the Software description page, provide the information that you want users to see in the company portal for the app, and then click Next. The following settings are available:

    Setting

    Details

    Publisher

    Enter the name of the publisher. For example, Microsoft or Contoso.

    Name

    Enter or change the name of the app. The app name is displayed in the company portal It is also used when you search for apps. Each app package should have a unique name. If the company portal detects multiple apps with the same name, it will only display one of the apps.

    Description

    Enter a description for the app. The description is displayed in the company portal.

    Category

    Select the category that best fits this app. Use Other Apps for an app that does not match the predefined categories. The category that you select is used to classify this app. This setting is optional.

    Display this as a featured app and highlight it in the company portal

    Select this option to display the app prominently in the company portal devices.

    Icon

    Choose whether to associate an icon with the app. The maximum size for the icon is 250 x 250 pixels. The recommended size is 32 x 32 pixels. This setting is optional.

  8. On the Requirements page, specify the requirements that must be met on computers before the app can be installed.

  9. Applies only to the Windows Installer (.exe) installation type

    On the Detection rules page, select Detect whether the is installed by using the following rules (recommended). If you select Use the default detection rules, it will automatically overwrite any previously installed app versions or customizations that might already exist on a computer. If the app setup file that you specified earlier is a .msi or .msp file, then the Detection rules page does not appear. These files contain their own instructions for detecting previous app installations.

  10. On the Add Rule list, select one or more of the available detection rule types:

    • File exists

    • MSI product code exists

    • Registry key exists

    You can create multiple detection rules. For example, you can create a File exists rule to search for an existing file in one file path, and then create another File exists rule to search for an existing file in a different file path. You can also create multiple detection rules of different types. For example, you can add a separate Registry key exists rule in addition to the previous example search criteria. When both of these rules are in place, Intune determines whether the file exists. If it does exist, the app is considered to be detected. If it does not exist, Intune examines whether the registry key exists.

    1. Select File exists from the Add Rule list, and then click Add.

    2. In Specify file path, complete the file path. Include the file name that you want Intune to find. To change the start of the file path to %SystemDrive%, click the %ProgramFiles% list, and then click %SystemDrive%.

      • If you select %ProgramFiles% as the start of the file path, Intune searches for the file in both Program Files\<file path> and Program Files (x86)\<file path>, where <file path> is the subfolder\file path that you enter.

      • If you select %SystemDrive% as the start of file path, Intune searches for the file starting from the root of the computer’s system drive. This is typically drive C.

      Examples:

      Specified path

      Search action

      Program Files\Microsoft Silverlight\Silverlight.Configuration.exe

      The system searches for Silverlight.Configuration.exe in the Program Files\Microsoft Silverlight and Program Files X86\Microsoft Silverlight folders and subfolders.

      %SystemDrive%\Silverlight.Configuration.exe

      The system searches for Silverlight.Configuration.exe throughout the whole system drive.

      %SystemDrive%\DevTools\Silverlight.Configuration.exe

      The system searches for Silverlight.Configuration.exe on the system drive, in the \DevTools folder and subfolders.

    1. Select MSI product code exists from the Add Rule list, and then click Add.

    2. In Choose an MSI file, click Browse to identify the name and location of a Windows Installer (.msi) file.

    1. Select Registry key exists from the Add Rule list, and then click Add.

    2. In Specify registry key path, complete the registry key name that starts with HKEY_LOCAL_MACHINE\.

      Intune checks both the 32-bit and 64-bit versions of the submitted registry path. If the registry key is found in either version, the app is considered to be detected.

  11. On the Command line arguments page, click Yes if your setup requires command-line arguments. If you are uploading an app that uses an executable setup file (.exe), it must run in unattended mode. Be sure to use any required command-line parameter (such as /q), to force the app to install silently (without user intervention).

  12. In Command line arguments, type the command-line arguments for the app, and then click Next.

  13. On the Return codes page, click Yes to add new error codes that are interpreted by Intune when the app installs on a managed computer.

    By default, the Microsoft Intune Software Publisher uses industry-standard return codes to report the failure or success of an app package installation. These return codes work with most industry-standard app.

    Return code

    Interpretation

    0

    Success

    3010

    Success with restart

    Intune interprets any return code not in this list a failure. For line-of-business apps, for example, you can add your own return codes.

  14. Select a return code type from the Add return code list, and then click Add.

  15. Enter the custom return code in the Return code box.

  16. After you add the custom return codes that you need, click Next.

  17. On the Summary page, review the app settings that you specified. You can change any setting by selecting the page in the page navigation pane and then edit the selections on the displayed page.

  18. Click Upload. The Upload page displays the status of the app as it uploads to Intune. Click Close to exit the wizard.

The app is ready to be deployed after you publish it to Intune cloud storage. Consider the following:

  • Cloud storage: Uploaded apps are stored in Intune cloud storage that your organization purchased. If you have insufficient free space to upload the app package, you are notified of this during the upload process. Intune cannot determine whether there is enough free space until after the app upload has started. For details, see Cloud storage requirements.

  • License agreements: The app is ready to be deployed after you publish it to Intune. Before you deploy the app, make sure you have the appropriate licenses for the app. For details, see Manage license agreements for computer software in Microsoft Intune.

When you deploy apps, depending on the deployment action you choose, the app will be made available for users to install from the company portal, automatically installed, or uninstalled. The deployment is targeted to all groups to which you deploy the app. Make sure create the user and device groups according to the needs of your app deployment. For details, see Use groups to manage users and devices with Microsoft Intune.

Create an app deployment

  1. In the Microsoft Intune administrator console, click Apps > Apps.

  2. Select the title of the computer app that you want to deploy, and then click Manage Deployment.

    System_CAPS_noteNote

    When you select multiple items, and include both mobile device apps and computer apps, you can only deploy the app as an Available Install.

  3. On the Select Groups page, select the user or device groups to which you want to deploy the app, and then click Next.

  4. On the Deployment Action page, select one of the following from the Approval column:

    • Available install – The app will be made available for users to install from the company portal.

    • Required install – The app will be automatically installed on computers to which it is deployed.

      To define a timeline for the app to be deployed, click the drop-down menu in the Deadline column, and select one of the following options:

      • None: Deploys the app based on the agent policy settings.

      • As soon as possible: During the next synchronization, Microsoft Intune scans client computers in the selected groups, and then deploys the app. For more information about how to schedule synchronization, see Use policies to manage computers and mobile devices with Microsoft Intune.

      • One week: This option deploys the app package one calendar week from the current day.

      • Two weeks: This option deploys the app package two calendar weeks from the current day.

      • One month: This option deploys the app package one calendar month from the current day.

      • Custom: This option lets you set a specific date and time for the app package to deploy.

      System_CAPS_importantImportant

      Deploying apps may take longer than expected. It can take up to an hour before newly deployed app is available to users.

    • Uninstall – The app will be uninstalled on computers to which this deployment is targeted (if uninstall is supported).

    • Not applicable – The app will not be installed automatically, or made available in the company portal.

    For more information about the deployment actions you can use, see Understand app deployment actions.

  5. When you are done, click Finish.

You can monitor app deployment status and app adoption in the Microsoft Intune administrator console.

System_CAPS_noteNote

Statistics for mobile apps will be displayed only if there are users to whom the app was deployed or if there are users who attempted to download the app.

To view apps

  1. In the Microsoft Intune administrator console, click Apps > Apps. Click any app in the listto display the status of the app and general information about the app.

    System_CAPS_noteNote

    Available user statistics relate to the number of users to whom the app is currently available; whereas the number of download attempts relates to all attempted downloads over time by any users to whom the app was available at any point.

  2. Click Filters, and then select a filter to restrict the displayed list of apps.

To view details for apps

  1. In the Microsoft Intune administrator console, click Apps > Apps. Click any app in the list to display the status and list general information about the app.

  2. Select the app, and then click View Properties for more information about the app. The following tabs are displayed:

    1. General: Provides details and links to the app status and details.

    2. Users: Provides the list of users to which the app was deployed.

    3. Computers: This tab is available for computer apps only. Provides the list of computers to which the app was deployed as a required installation.

To view the list of computers running required apps

  1. In the Microsoft Intune administrator console, click Apps > Apps , and then select an app title.

  2. In the preview pane, click the Installation Count number.

    Intune lists all computers that have the selected app title. The following information is displayed:

    • Managed computer names that have the selected app title installed.

    • The operating system that each managed computer is running.

    • The version of the selected app title.

    • Whether the instance of the selected app is virtual or installed. Icons that are displayed next to each computer name identify the computer as virtual or physical.

    • The last time the computer reported inventory to Microsoft Intune. Double-click any computer in the list to retrieve additional information.

For details about detected app reports, see Understand Microsoft Intune operations by using reports.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft