> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# microsoft-active-directory-devices

> Active Directory Devices — manage Azure AD devices and Intune managed devices (wipe, retire, sync)

**Server path:** `/microsoft-active-directory-devices` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                                                                    | Description                                |
| --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| [`microsoft_active_directory_devices_delete_device`](#microsoft_active_directory_devices_delete_device)                                 | Delete a device                            |
| [`microsoft_active_directory_devices_get_device`](#microsoft_active_directory_devices_get_device)                                       | Get a device by ID                         |
| [`microsoft_active_directory_devices_get_managed_device`](#microsoft_active_directory_devices_get_managed_device)                       | Get an Intune managed device               |
| [`microsoft_active_directory_devices_list_device_registered_owners`](#microsoft_active_directory_devices_list_device_registered_owners) | List registered owners of a device         |
| [`microsoft_active_directory_devices_list_device_registered_users`](#microsoft_active_directory_devices_list_device_registered_users)   | List registered users of a device          |
| [`microsoft_active_directory_devices_list_devices`](#microsoft_active_directory_devices_list_devices)                                   | List devices                               |
| [`microsoft_active_directory_devices_list_managed_devices`](#microsoft_active_directory_devices_list_managed_devices)                   | List Intune managed devices                |
| [`microsoft_active_directory_devices_retire_managed_device`](#microsoft_active_directory_devices_retire_managed_device)                 | Retire an Intune managed device            |
| [`microsoft_active_directory_devices_sync_managed_device`](#microsoft_active_directory_devices_sync_managed_device)                     | Force a managed device to sync with Intune |
| [`microsoft_active_directory_devices_wipe_managed_device`](#microsoft_active_directory_devices_wipe_managed_device)                     | Wipe an Intune managed device              |

***

## microsoft\_active\_directory\_devices\_delete\_device

Delete a device

**Parameters:**

| Parameter   | Type   | Required | Default | Description |
| ----------- | ------ | -------- | ------- | ----------- |
| `device_id` | string | Yes      | —       | Device Id   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "device_id": {
        "type": "string",
        "description": "Device Id"
      }
    },
    "required": [
      "PCID",
      "device_id"
    ]
  }
  ```
</Expandable>

***

## microsoft\_active\_directory\_devices\_get\_device

Get a device by ID

**Parameters:**

| Parameter   | Type   | Required | Default | Description             |
| ----------- | ------ | -------- | ------- | ----------------------- |
| `device_id` | string | Yes      | —       | Device object ID (GUID) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "device_id": {
        "type": "string",
        "description": "Device object ID (GUID)"
      }
    },
    "required": [
      "PCID",
      "device_id"
    ]
  }
  ```
</Expandable>

***

## microsoft\_active\_directory\_devices\_get\_managed\_device

Get an Intune managed device

**Parameters:**

| Parameter           | Type   | Required | Default | Description       |
| ------------------- | ------ | -------- | ------- | ----------------- |
| `managed_device_id` | string | Yes      | —       | Managed Device Id |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "managed_device_id": {
        "type": "string",
        "description": "Managed Device Id"
      }
    },
    "required": [
      "PCID",
      "managed_device_id"
    ]
  }
  ```
</Expandable>

***

## microsoft\_active\_directory\_devices\_list\_device\_registered\_owners

List registered owners of a device

**Parameters:**

| Parameter   | Type   | Required | Default | Description |
| ----------- | ------ | -------- | ------- | ----------- |
| `device_id` | string | Yes      | —       | Device Id   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "device_id": {
        "type": "string",
        "description": "Device Id"
      }
    },
    "required": [
      "PCID",
      "device_id"
    ]
  }
  ```
</Expandable>

***

## microsoft\_active\_directory\_devices\_list\_device\_registered\_users

List registered users of a device

**Parameters:**

| Parameter   | Type   | Required | Default | Description |
| ----------- | ------ | -------- | ------- | ----------- |
| `device_id` | string | Yes      | —       | Device Id   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "device_id": {
        "type": "string",
        "description": "Device Id"
      }
    },
    "required": [
      "PCID",
      "device_id"
    ]
  }
  ```
</Expandable>

***

## microsoft\_active\_directory\_devices\_list\_devices

List devices

**Parameters:**

| Parameter | Type    | Required | Default | Description        |
| --------- | ------- | -------- | ------- | ------------------ |
| `$filter` | string  | No       | —       | The \$filter value |
| `$select` | string  | No       | —       | The \$select value |
| `$top`    | integer | No       | —       | The \$top value    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "$filter": {
        "type": "string",
        "description": "The $filter value"
      },
      "$select": {
        "type": "string",
        "description": "The $select value"
      },
      "$top": {
        "type": "integer",
        "description": "The $top value"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## microsoft\_active\_directory\_devices\_list\_managed\_devices

List Intune managed devices

**Parameters:**

| Parameter | Type    | Required | Default | Description        |
| --------- | ------- | -------- | ------- | ------------------ |
| `$filter` | string  | No       | —       | The \$filter value |
| `$select` | string  | No       | —       | The \$select value |
| `$top`    | integer | No       | —       | The \$top value    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "$filter": {
        "type": "string",
        "description": "The $filter value"
      },
      "$select": {
        "type": "string",
        "description": "The $select value"
      },
      "$top": {
        "type": "integer",
        "description": "The $top value"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## microsoft\_active\_directory\_devices\_retire\_managed\_device

Retire an Intune managed device

**Parameters:**

| Parameter           | Type   | Required | Default | Description       |
| ------------------- | ------ | -------- | ------- | ----------------- |
| `managed_device_id` | string | Yes      | —       | Managed Device Id |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "managed_device_id": {
        "type": "string",
        "description": "Managed Device Id"
      }
    },
    "required": [
      "PCID",
      "managed_device_id"
    ]
  }
  ```
</Expandable>

***

## microsoft\_active\_directory\_devices\_sync\_managed\_device

Force a managed device to sync with Intune

**Parameters:**

| Parameter           | Type   | Required | Default | Description       |
| ------------------- | ------ | -------- | ------- | ----------------- |
| `managed_device_id` | string | Yes      | —       | Managed Device Id |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "managed_device_id": {
        "type": "string",
        "description": "Managed Device Id"
      }
    },
    "required": [
      "PCID",
      "managed_device_id"
    ]
  }
  ```
</Expandable>

***

## microsoft\_active\_directory\_devices\_wipe\_managed\_device

Wipe an Intune managed device

**Parameters:**

| Parameter             | Type    | Required | Default | Description            |
| --------------------- | ------- | -------- | ------- | ---------------------- |
| `managed_device_id`   | string  | Yes      | —       | Managed Device Id      |
| `keepEnrollmentData`  | boolean | No       | —       | Keep Enrollment Data   |
| `keepUserData`        | boolean | No       | —       | Keep User Data         |
| `macOsUnlockCode`     | string  | No       | —       | Mac Os Unlock Code     |
| `persistEsimDataPlan` | boolean | No       | —       | Persist Esim Data Plan |
| `useProtectedWipe`    | boolean | No       | —       | Use Protected Wipe     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "managed_device_id": {
        "type": "string",
        "description": "Managed Device Id"
      },
      "keepEnrollmentData": {
        "type": "boolean",
        "description": "Keep Enrollment Data"
      },
      "keepUserData": {
        "type": "boolean",
        "description": "Keep User Data"
      },
      "macOsUnlockCode": {
        "type": "string",
        "description": "Mac Os Unlock Code"
      },
      "persistEsimDataPlan": {
        "type": "boolean",
        "description": "Persist Esim Data Plan"
      },
      "useProtectedWipe": {
        "type": "boolean",
        "description": "Use Protected Wipe"
      }
    },
    "required": [
      "PCID",
      "managed_device_id"
    ]
  }
  ```
</Expandable>