Appearance
Overview
This article explains how the imper.ai collector script runs on a recurring schedule through your MDM, so imper.ai keeps checking your devices after hire.
| Platform | MDM | Who sets the schedule |
|---|---|---|
| Mac | Iru | imper.ai, through the Iru integration |
| Windows | Microsoft Intune | You, in the Intune admin center |
To use another MDM, such as Jamf, contact imper.ai.
Iru (Mac)
With the Iru integration, imper.ai deploys and schedules the collector for you. When you connect Iru, imper.ai creates a Custom Script Library Item in your Iru tenant and assigns it to the Blueprints or Assignment ID you selected. The item is configured as follows:
| Setting | Value |
|---|---|
| Name | imper-verification |
| Execution frequency | Every 15 minutes |
| Show in Self Service | Off |
There is nothing to schedule on your side. If you change the Blueprints or Assignment ID, or remove the integration, imper.ai deletes this item from your Iru tenant.
Microsoft Intune (Windows)
With Microsoft Intune, you deploy the collector script yourself. Intune offers two ways to run a PowerShell script, and only one of them runs on a schedule:
| Intune feature | How often it runs | Licensing |
|---|---|---|
| Remediations | On the schedule you set | Windows Enterprise E3 or E5, Windows Education A3 or A5, or Windows Virtual Desktop Access (VDA) per user |
| Platform scripts | Once per device | Included with Intune |
To check devices continuously, use Remediations. Use a platform script only if a single check per device is enough.
Remediations prerequisites
- Every user of the targeted devices has one of the licenses listed above. Microsoft 365 Business Premium alone does not include them.
- Devices are Microsoft Entra joined or Microsoft Entra hybrid joined.
- Before the first use, an Intune Service Administrator confirms the licensing requirements in the Intune admin center.
Run the collector on a schedule with Remediations
- In the Microsoft Intune admin center, go to Devices > Scripts and remediations > Remediations, then click Create.
- Enter a Name (for example,
imper.ai collector) and click Next. - Under Settings:
- Detection script file - upload the collector script (
.ps1) from the imper.ai console. - Remediation script file - leave empty.
- Run this script using the logged-on credentials - No, so the script runs in the system context.
- Run script in 64-bit PowerShell - Yes.
- Detection script file - upload the collector script (
- Click Next through Scope tags.
- Under Assignments, select the device group you chose when connecting Intune to imper.ai.
- Set the Schedule for the assignment (for example, Daily at a set time), then click Next.
- Review and click Create.
Schedules use the device's local time by default; select Use UTC to schedule in UTC instead. If a device is offline at the scheduled time, the script runs as soon as the device is back online.
Run the collector once with a platform script
See Step 4: Deploy the collector script in the Intune integration guide.
Related articles
- Use Remediations to detect and fix support issues - Microsoft Learn
Need help or have a question? support@imper.ai