Microsoft Intune
Device security

Create Discovery Scripts for Custom Compliance Policy in Microsoft Intune - Microsoft Intune | Microsoft Learn

In brief

The page received editorial updates, including title capitalization, wording, links, and formatting. The Windows instructions no longer list the 64-bit PowerShell host setting.

What Intune admins need to know

Review the updated Windows script guidance when creating or maintaining custom compliance discovery scripts.

This summary was assembled from the tracked documentation change. Verify important details in the full Microsoft Learn article.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

Create discovery scriptsDiscovery Scripts for custom compliance policyCustom Compliance Policy in Microsoft Intune - Microsoft Intune | Microsoft Learn

Before you can use custom settings for compliance with Microsoft Intune, you must create a script that discovers custom compliance settings on devices. The script you use depends on the platform:

All discovery scripts:

  • Are added to Intune before you create a compliance policy. After you add a script, it's available to select when you create a compliance policy with custom settings.

    • Each discovery script can only be used with one compliance policy, and each compliance policy can only include one discovery script.
    • You can't delete discovery scripts that are assigned to a compliance policy until you unassign the script from the policy.
  • Run on a device that receives the compliance policy. The script evaluates the conditions of the JSON file you upload when creating a custom compliance policy.

  • Scripts can be no larger than 1 megabyte (MB) each.

  • Output generated by each script can be no larger than 1 MB.

  • Scripts must have a limited run time:

    • On Linux, scripts must take five minutes or less to run.
    • On macOS, scripts must take 10 minutes or less to run.
    • On Windows, scripts must take 10 minutes or less to run.

Note

On Linux, discovery scripts run in theyour user's context. They can't check for system-level settings that require elevation. An example of this limitation is the state/hash of the /etc/sudoers file.

Discovery scripts for Linux can call any interpreter that meets your requirements. Ensure that the chosen interpreter is properly installed and configured on the target device before deploying the script. To specify the interpreter for a script, include a shebang line at the top of the script, indicating the path to the interpreter binary.

To handle interrupts or cancellation signals, implement graceful termination mechanisms in your scripts. When a script handles these signals, it can perform cleanup tasks and exit gracefully, ensuring resources are released correctly. For example, catch signals like SIGINT (interrupt signal) or SIGTERM (termination signal) and define custom actions to run when they're received. These actions can include closing open files, releasing acquired locks, or cleaning up temporary resources.

For more information, see the Intune Linux Custom Compliance Samples guide..

Sample discovery script for macOS

Discovery scripts for macOS use Bash and must include a valid shebang line (for example,line, such as #!/bin/bash). Scripts must be UTF-8 encoded without BOM, and must return exit code 0 for success and a non-zero exit code for failure.

The following example returns the version of the Microsoft Intune Agent app installed on the device:

Add a discovery script to Intune

Before deployingyou deploy your script in production, test it in an isolated environment to ensure the syntax you use behaves as expected.

  1. Sign intoin to Microsoft Intune admin center and go to Endpoint security > Device compliance > Scripts > Add > (choose your platform).

  2. On Basics, provide a Name.

  3. On Settings, add your script to Detection script. Review your script carefully. Intune doesn’t validate the script for syntax or programmatic errors.

  4. For macOS - On Settings, configure the following behavior for the Bash script:

    • Run this script using the logged on credentials –. Set this value to Yes to run the script in the context of the logged-on user.
    • Enforce script signature check –. Set this value to Yes to require a valid signature on the script.
    • Hide script notifications on devices –. Set this value to Yes to hide notifications from the script on the device.

    For Windows only -: On Settings, configure the following behavior for the PowerShell script:

Note

The script upload workflow doesn't support scope tags. You must be assigned the default scope tag to create, edit, or view custom compliance discovery scripts.

  • \ No newline at end of file - Run this script using the logged on credentials –. By default, the script runs in the System context on the device. Set this value to Yes to have it run in the context of the logged-on user. If the user isn't logged in, the script defaults back to the System context.

  • - Enforce script signature check –. For more information, see about_Signing in the PowerShell documentation.
  • . - Run script in 64 bit PowerShell Host –. By default, the script runs using the 32-bit PowerShell host. Set this value to Yes to force the script to run using the 64-bit host instead.
  1. 5. Complete the script creation process. The script appears in the Scripts pane and is available to select when configuring compliance policies. \ No newline at end of file \ No newline at end of file

Daily Intune.Admin.News

Get daily email updates

Get a concise summary of the latest Microsoft Intune updates delivered straight to your inbox.

Loading the secure signup form…