# Outphase Devices

### Description

This runbook outphases multiple devices based on a comma-separated list of device IDs or serial numbers. It can optionally wipe devices in Intune and delete or disable the corresponding Entra ID device objects.

### Location

Organization → Devices → Outphase Devices

**Full Runbook name**

rjgit-org\_devices\_outphase-devices

### Permissions

#### Application permissions

* **Type**: Microsoft Graph
  * DeviceManagementManagedDevices.PrivilegedOperations.All
  * DeviceManagementManagedDevices.ReadWrite.All
  * DeviceManagementServiceConfig.ReadWrite.All
  * Device.Read.All

#### RBAC roles

* Cloud device administrator

### Parameters

#### DeviceListChoice

Determines whether the list contains device IDs or serial numbers.

| Property      | Value |
| ------------- | ----- |
| Required      | true  |
| Default Value | 0     |
| Type          | Int32 |

#### DeviceList

Comma-separated list of device IDs or serial numbers.

| Property      | Value  |
| ------------- | ------ |
| Required      | true   |
| Default Value |        |
| Type          | String |

#### intuneAction

Determines whether to wipe the device, delete it from Intune, or skip Intune actions.

| Property      | Value |
| ------------- | ----- |
| Required      | false |
| Default Value | 2     |
| Type          | Int32 |

#### aadAction

Determines whether to delete the Entra ID device, disable it, or skip Entra ID actions.

| Property      | Value |
| ------------- | ----- |
| Required      | false |
| Default Value | 2     |
| Type          | Int32 |

#### wipeDevice

Internal flag derived from intuneAction.

| Property      | Value   |
| ------------- | ------- |
| Required      | false   |
| Default Value | True    |
| Type          | Boolean |

#### removeIntuneDevice

Internal flag derived from intuneAction.

| Property      | Value   |
| ------------- | ------- |
| Required      | false   |
| Default Value | False   |
| Type          | Boolean |

#### removeAutopilotDevice

"Remove the device from Autopilot" (final value: true) or "Keep device in Autopilot" (final value: false) handles whether to delete the device from the Autopilot database.

| Property      | Value   |
| ------------- | ------- |
| Required      | false   |
| Default Value | True    |
| Type          | Boolean |

#### removeAADDevice

Internal flag derived from aadAction.

| Property      | Value   |
| ------------- | ------- |
| Required      | false   |
| Default Value | True    |
| Type          | Boolean |

#### disableAADDevice

Internal flag derived from aadAction.

| Property      | Value   |
| ------------- | ------- |
| Required      | false   |
| Default Value | False   |
| Type          | Boolean |

[Back to Runbook Reference overview](/automation/runbooks/runbook-references.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.realmjoin.com/automation/runbooks/runbook-references/org/devices/outphase-devices.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
