Applies To: □ New PoliteMail ■ Legacy PoliteMail
Version: ■ 4.9+ ■ 5.0+
To deploy PoliteMail via Intune, two steps must be performed, one by PoliteMail, and the other by you.
- PoliteMail will create needed install and uninstall CMD scripts, and create the Intune package in the appropriate needed format (a .intunewin file). PoliteMail will then send the package file to you, with the version number.
- You will add PoliteMail to the Intune portal to deploy the application using the instructions provided in this Guide.
What is Intune?
Microsoft Intune is a cloud-based endpoint management solution. It manages user access and simplifies app & device management across your many devices, including mobile devices, desktop computers, and virtual endpoints.
Intune makes it easy to manage users and devices, as well as simplify application deployment and management. You can find out more about Intune here.
Preparation
Before you begin the process, you will need to perform the following steps:
- It is recommended to create a new folder (name it ‘Intune’) with two subfolders (name them ‘Input’ and ‘Output’). The Intune folder will contain the Intune Prep Tool, and the Input folder will contain your PoliteMail Client executable as well as your install and uninstall .cmd files.
- Creating these folders is optional but will help keep you organized.
- Download and install the Intune Prep Tool to the parent folder you created.
- You can learn more about using the Prep Tool and preparing content for upload via Microsoft documentation here.
- The actual file name is IntuneWinAppUtil.exe, and is downloaded via GitHub.
Creating the Needed Files (PoliteMail)
This step is done by PoliteMail for you.
In order to create the Intune package for deployment, PoliteMail will place the .cmd for installation, the .cmd file for uninstallation, and the PoliteMail Client.exe file in the Intune Prep Tool Input folder.
PoliteMail will then run the Intune Prep Tool to create the finished Intune package file, which will be sent to you.
Deploying PoliteMail via Intune
This step is done by you.
To deploy PoliteMail via Intune, you should have received the PoliteMail package file (in a .intunewin format) and the version number.
Uploading and deploying the PoliteMail package via Intune is done via the EndPoint Manager at https://endpoint.microsoft.com. This is available to Intune admins (those who have deployed applications before) only.
- Click on 'Apps' from the left panel. The Apps window will display.
- When you click on 'All Apps', PoliteMail will appear in the app list if it has already been deployed.
- From All Apps, click 'Add'. A side panel appears.
- Click the drop-down to select an app type and scroll to select 'Windows App (Win32).
- Click Select. The panel will close and the 'Add App' window will display.
The Add App Window
The ‘Add App’ window has 8 steps, laid out as tabs across to the top.
1: App Information
Click the ‘Select app package file’ link. A side panel appears. Click the blue button to navigate to your package file (.intunewin).
Click the ‘Select app package file’ link. A side panel appears. Click the blue button to navigate to your package file (.intunewin).- Click Open, the click OK to close the panel. Once the file has been specified, additional fields appear for you to complete.
| Field | Entry |
|---|---|
Name | This will be the name of the app as it will appear in the App list. We recommend something like ‘PoliteMail v5.0’. |
Description | Enter an appropriate description of the application. A suggested description would be ‘PoliteMail is an Outlook Add-In that allows the creation of content-rich email, in-depth metrics, and speedier delivery of internal messaging, all from within the Outlook interface.’ |
Publisher | PoliteMail Software |
App Version | Enter the version number provided by PoliteMail with the Intune package. |
Category | Productivity |
Show as Featured App… | Yes |
Information URL | www.politemail.com |
Privacy URL | www.politemail.com/privacy |
Developer | PoliteMail Software |
Owner | PoliteMail Software |
Notes | Notes are optional |
Logo | If you have access to a PoliteMail logo, upload it here. |
2: Program
Enter the name of the .cmd install script (probably install-politemail.cmd) and the name of the uninstall script (probably uninstall-politemail.cmd).- You will typically leave the install behavior as System, and all other fields on the screen can be left at their default.
Enter the name of the .cmd install script (probably install-politemail.cmd) and the name of the uninstall script (probably uninstall-politemail.cmd).3: Requirements (optional)
The Requirements screen allows you to specify minimum OS and/or hardware requirements to allow installation, if desired. PoliteMail recommends a minimum 100MB of disk space, 8GB or physical memory, and 2 processors.
4: Detection Rules (optional)
Detection Rules allow Intune to detect if there was a successful installation based on criteria you set. For example, you can add a rule to look at the MSI file, another file, or the registry.
- To verify successful PoliteMail installation, you can specify the following:
| Field | Entry |
|---|---|
Rule Type | Registry |
Key Path | Computer\HKEY_CURRENT_USER\Software\VB and VBA Program Settings\Salestream\Config |
Value Name | Username |
Detection Method | Value Exists |
5: Dependencies (optional)
You can add other applications (for example, WebView2) that must be installed prior to the PoliteMail application.
6: Supersedence (optional)
Supersedence allows you to set if the application is an update to or replaces an existing application that is already installed. This is useful, for example, if users are upgrading from a previous version.
7: Assignments
This window is where you assign the application to Entra ID groups, all users, or all devices.
- If you have not done so already, you will need to create a group for your PoliteMail users.
- Under the ‘Required’ section, select ‘Add Group’. A side panel opens for you to select the group you wish to deploy PoliteMail to. Enter the group name to search for it, select it, and click Select. Note that you can select multiple groups if needed.
8: Review + Create
: Review + Create
This section summarizes your information. Review the content and if everything looks correct, click on Create. If successful, you will now see PoliteMail in the All Apps list.
Viewing Deployment Status
From the All Apps list in the Endpoint Manager, you can click on the PoliteMail app from the list to view the deployment status. The application will be installed on user devices over time.
