CIPP icon

CIPP

Interact with CIPP API

Actions129

Overview

This node operation assigns an Intune policy to specified targets within a Microsoft tenant. It is useful for automating the deployment of device or user policies across an organization managed via Microsoft Intune. For example, an IT administrator can use this node to assign a compliance policy to all users, all devices, both, or a custom group within their tenant, streamlining policy management and enforcement.

Use Case Examples

  1. Assign a compliance policy to all users in the tenant.
  2. Assign a device configuration policy to a custom group of devices.

Properties

Name Meaning
Tenant Filter The default .onmicrosoft.com tenant name to specify the Microsoft tenant context for the operation.
Assign To Specifies the target of the policy assignment, which can be all users, all devices, both users and devices, or a custom group.
Policy ID The unique identifier of the Intune policy to be assigned.
Request Options Optional settings to control request behavior such as batching, SSL certificate validation, proxy usage, and request timeout.

Output

JSON

  • assignmentStatus - Status of the policy assignment operation.
  • assignedPolicyId - The ID of the policy that was assigned.
  • target - The target entity (users, devices, or group) to which the policy was assigned.

Dependencies

  • Requires authentication credentials for Microsoft Intune API access, typically an API key or OAuth token.

Troubleshooting

  • Ensure the Tenant Filter is correctly set to the tenant's .onmicrosoft.com domain to avoid authentication errors.
  • Verify that the Policy ID is valid and exists in the Intune environment to prevent assignment failures.
  • If using a custom group, confirm the group ID is correct and accessible.
  • Check network settings if using a proxy or if SSL issues occur; enabling 'Ignore SSL Issues' can bypass certificate validation but is insecure.
  • Timeout errors may occur if the server is slow or unresponsive; adjust the timeout setting accordingly.

Links

Discussion