Skip to content
imper.ai

Running the Collector from Your MDM

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.

PlatformMDMWho sets the schedule
MacIruimper.ai, through the Iru integration
WindowsMicrosoft IntuneYou, 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:

SettingValue
Nameimper-verification
Execution frequencyEvery 15 minutes
Show in Self ServiceOff

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 featureHow often it runsLicensing
RemediationsOn the schedule you setWindows Enterprise E3 or E5, Windows Education A3 or A5, or Windows Virtual Desktop Access (VDA) per user
Platform scriptsOnce per deviceIncluded 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 ​

  1. In the Microsoft Intune admin center, go to Devices > Scripts and remediations > Remediations, then click Create.
  2. Enter a Name (for example, imper.ai collector) and click Next.
  3. 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.
  4. Click Next through Scope tags.
  5. Under Assignments, select the device group you chose when connecting Intune to imper.ai.
  6. Set the Schedule for the assignment (for example, Daily at a set time), then click Next.
  7. 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.

Need help or have a question? support@imper.ai