Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

This article instructs on how to deploy Breeze agent via Microsoft Intune.

Breeze Agent can be deployed to Windows machine as a Windows app (Win32) application in Microsoft Intune.

Prepare the package necessary for creating the application in Microsoft Intune


1. On Windows 10 machine v1607 or later, download the Microsoft Win32 Content Prep Tool.
2. Create a temporary working directory on the disk and put the downloaded tool inside (e.g., C:\breeze).
3. Create a source directory named source inside (C:\breeze\source).
4. Rename the Breeze Agent distro file to the breeze-agent.exe and put it in the source directory (C:\breeze\source\breeze-agent.exe).
5. In the source directory, create a new plain-text file in UTF-8 encoding named install.cmd (C:\breeze\source\install.cmd) and paste the following content into it:

Code Block
languagebash
@echo off
start /B /WAIT breeze-agent.exe -gm2
if %errorlevel% NEQ 0 ( exit /b 1 )
setlocal EnableDelayedExpansion
set etc=%ProgramFiles%\Breeze\etc
if exist "!etc!" (
  set tags=!etc!\tags
  if not exist "!tags!" echo. 2>"!tags!"
  set str=preferred.descriptor=intune
  find /c "!str!" "!tags!" >NUL || echo:!str!>>"!tags!"
) else (
  exit /b 1
)

6. Start the command line and go to the working directory using the command:

Code Block
C: && cd C:\Breeze

7. Create .intunewin package using the following command line:

Code Block
languagebash
IntuneWinAppUtil.exe -c C:\breeze\source -o C:\breeze -s C:\breeze\source\breeze-agent.exe

8. In the working directory there should be the package file (C:\breeze\breeze-agent.intunewin) to use in the next steps.

NOTE: more details about this process are available in Microsoft Intune documentation.

Create the Intune application


1. In the Microsoft Intune admin center, select Apps → All apps → Add.
2. On the pane 'Select app type', under the 'Other' select Windows app (Win32) from the list and click Select.
3. Click Select app package file and navigate to the .intunewin file created before. When the app details appear, select Ok.
Populate mandatory fields with the following values:

Name: Breeze Agent
Description: [set up a meaningful description]
Publisher: Cloudaware

4. On the next pane 'Program', populate fields as described below:

Install command: "%systemroot%\sysnative\cmd.exe" /c "install.cmd"
Uninstall command: "%systemroot%\sysnative\cmd.exe" /c "%ProgramFiles%\Breeze\uninstall.bat"
Install behavior: System
Device restart behavior: No specific action
Specify return codes to indicate post-installation behavior:
0: Success
1: Failed

5. On the next page 'Requirements', the mandatory fields are as follows:

Operating system architecture: select only 64-bit
Minimum operating system: Windows 10 1607

6. On the page ‘Detection rules', select Manually configure detection rules. Click Add and select File as 'Rule type’. The mandatory fields are as follows:

Path: %ProgramFiles%
File or folder: Breeze
Detection method: File or folder exists
Associated with 32-bit app on 64-bit clients: No

7. Leave the pages 'Dependencies' and 'Supersedence' empty.
8. On the page 'Assignments' configure desired targets for the application deployment.
9. On the page 'Review and create', review the values and settings of the app. Please ensure that the app configuration information is correct. Select Create.

NOTE: more details about this process are available in Microsoft Intune documentation.