CIPP icon

CIPP

Interact with CIPP API

Actions129

Overview

This node interacts with the Intune resource of the CIPP API to remove a specified policy. It is useful in scenarios where administrators need to programmatically delete policies from their Intune environment, such as cleaning up outdated or unused policies. For example, an IT admin can automate the removal of a device compliance policy by specifying the policy ID and tenant filter.

Use Case Examples

  1. Remove a device compliance policy by providing the tenant's default .onmicrosoft.com name and the policy ID to be removed.
  2. Automate policy cleanup in Intune by scheduling this node to remove policies no longer needed.

Properties

Name Meaning
Tenant Filter The default .onmicrosoft.com tenant name used to identify the Intune environment.
Policy ID The unique identifier of the policy to be removed from Intune.
Request Options Optional settings to control request behavior such as batching, SSL certificate validation, proxy usage, and timeout duration.

Output

JSON

  • success - Indicates whether the policy removal operation was successful.
  • message - Provides additional information or error messages related to the removal operation.

Dependencies

  • Requires an API key credential for authenticating with the CIPP API, specifically for accessing Intune resources.

Troubleshooting

  • Ensure the Tenant Filter is correctly set to the default .onmicrosoft.com tenant name; incorrect values may cause authentication or resource identification failures.
  • Verify the Policy ID is valid and exists in the Intune environment; invalid IDs will result in errors or no action.
  • Check network connectivity and proxy settings if requests fail or time out.
  • If SSL certificate validation errors occur, consider enabling the option to ignore SSL issues, but be aware of security risks.

Discussion