Actions129
- Calendar Permission Actions
- CIPP Administration Actions
- Execute API Client (GET)
- Execute Auto Backup
- Execute Extension Mapping (GET)
- Execute Extension Mapping (POST)
- Execute Extension Sync
- Execute Extensions Config
- Execute Password Config (POST)
- Execute Restore Backup
- Execute Run Backup
- List Custom Roles
- List Extension Sync
- List Logs
- List Scheduled Items
- Remove Scheduled Item
- Execute API Client (POST)
- Execute Extension Test
- Execute Password Config (GET)
- List Backups
- List Function Parameters
- Group Actions
- Intune Actions
- Add MSP App
- Add Office App
- Add Policy
- Add Store App
- Assign App
- Assign Autopilot Device
- Device Action
- Get Recovery Key
- List Applications
- List Application Queue
- List Autopilot Config
- List Devices
- List Intune Scripts
- List Intune Templates
- Remove Autopilot Device
- Remove Policy
- Remove Queued App
- Add Choco App
- Add WinGet App
- Assign Policy
- Get Local Admin Password
- List Autopilot Devices
- List Intune Policies
- Remove App
- Remove Intune Script
- Sync Autopilot Devices
- License Actions
- Security & Compliance Actions
- Teams & SharePoint Actions
- Tenant Actions
- Add Alert
- Clear Tenant Cache
- Execute CA Exclusion
- Execute Named Location
- Get Tenant
- List Alerts Queue
- List Azure AD Connect Status
- List Conditional Access Policies
- List Named Locations
- List Shared Mailbox Statistics
- List Standards
- List Tenants
- Remove Standard Template
- Add Named Location
- Edit Tenant
- Execute Standards Run
- List Audit Logs
- List CSP Licenses
- List Roles
- List Standard Templates
- Tool Actions
- User Actions
- Add User
- Exec Restore Deleted User
- List User
- List User Conditional Access Policies
- List User Groups
- Clear Immutable ID
- Create Temporary Access Password
- Delete User Device
- Dismiss Risky User
- List Deleted Items
- List Inactive Accounts
- List Sign-Ins
- Remove User
- Reset MFA
- Restore Deleted Item
- Revoke Sessions
- Set Email Forward
- Set Per-User MFA
- List All Users
- List User Counts
- List User Devices
- Convert Mailbox
- Disable User
- Enable Archive
- List MFA Users
- Offboard User
- Reset Password
- Send MFA Push
- Set Out of Office
Overview
This node interacts with the CIPP API to manage user devices, specifically allowing the deletion, enabling, or disabling of a user device by its Device ID. It is useful in scenarios where administrators need to control device access for users, such as revoking access from lost or compromised devices or re-enabling devices after maintenance.
Use Case Examples
- An IT administrator deletes a device from a user's account to prevent unauthorized access.
- A security officer disables a device temporarily while investigating suspicious activity.
- A support technician enables a previously disabled device after resolving an issue.
Properties
| Name | Meaning |
|---|---|
| Device ID | The unique identifier of the user device to be acted upon. This is required to specify which device to delete, enable, or disable. |
| Device Action | The action to perform on the device, which can be Enable, Disable, or Delete. This determines how the device will be managed. |
| Request Options | Additional request settings such as batching, SSL certificate validation, proxy configuration, and request timeout to customize the API call behavior. |
Output
JSON
success- Indicates whether the device action was successfully completed.message- Provides additional information or confirmation about the device action performed.
Dependencies
- Requires an API key credential for authenticating with the CIPP API.
Troubleshooting
- Ensure the Device ID is correct and exists in the system; otherwise, the API may return an error indicating the device was not found.
- Verify that the API credentials are valid and have sufficient permissions to perform device management actions.
- If SSL certificate validation errors occur, consider enabling the 'Ignore SSL Issues' option, but be aware of the security implications.
- Check proxy settings if the node cannot reach the API endpoint, especially in restricted network environments.
- Timeout errors may occur if the server is slow to respond; adjust the timeout setting accordingly.