<!--
{
  "availability" : [
    "macOS: 11.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/LOM-Device-Request-Command",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rest:put:mdm#LOMDeviceRequestCommand"
  },
  "title" : "LOM Device Request"
}
-->

# LOM Device Request

Send requests to a device using lights-out management (LOM).

## Discussion

This command requires the `DeviceLockAndRemovePasscode` access right, [`LightsOutManagementLOM`](/documentation/DeviceManagement/LightsOutManagementLOM) configuration and is available in macOS 11 and later on [supported macOS devices](https://support.apple.com/guide/deployment/lights-out-management-payload-settings-dep580cf25bc/web).

`DeviceDNSName` is the `CommonName` in the Identity issued on the client certificate from [`LightsOutManagementLOM`](/documentation/DeviceManagement/LightsOutManagementLOM). [`LOMSetupRequestResponse`](/documentation/DeviceManagement/LOMSetupRequestResponse) returns `PrimaryIPv6AddressList` and `SecondaryIPv6AddressList` after a successful deployment of Lights Out management configuration payload and subsequent [`LOMSetupRequestCommand`](/documentation/DeviceManagement/LOMSetupRequestCommand).

### Command availability

|||
|--------------------------|---------------------------|
|Device channel            |macOS                      |
|User channel              |N/A                        |
|Requires supervision      |macOS                      |
|Allowed in user enrollment|N/A                        |
|Required access right     |DeviceLockAndRemovePasscode|

### Example request and response

**Request:**

```plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Command</key>
    <dict>
        <key>RequestList</key>
    <array>
        <dict>
            <key>DeviceDNSName</key>
            <string>lomdevice.com</string>
            <key>DeviceRequestType</key>
            <string>Reset</string>
            <key>DeviceRequestUUID</key>
            <string>0001</string>
            <key>PrimaryIPv6AddressList</key>
            <array>
                <string>fe80::94f6:d6ff:fef3:c05b</string>
                <string>fe80::94f6:d6ff:fef3:c1a4</string>
            </array>
            <key>SecondaryIPv6AddressList</key>
            <array/>
        </dict>
    </array>
    </dict>
    <key>CommandUUID</key>
    <string>0001_LOMDeviceRequest</string>
</dict>
</plist>
```

**Response:**

```plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>CommandUUID</key>
    <string>0001_LOMDeviceRequest</string>
    <key>ResponseData</key>
    <array>
        <dict>
            <key>DeviceRequestSucess</key>
            <true/>
            <key>DeviceRequestUUID</key>
            <string>0001</string>
        </dict>
    </array>
    <key>Status</key>
    <string>Acknowledged</string>
    <key>UDID</key>
    <string>37CECCAB-99C1-5ADF-8A9A-2AFA3B6387B5</string>
</dict>
</plist>
```

## Topics

### Commands and responses

[`LOMDeviceRequestCommand`](/documentation/DeviceManagement/LOMDeviceRequestCommand)

The command to send requests to a device using lights-out management (LOM).

[`LOMDeviceRequestResponse`](/documentation/DeviceManagement/LOMDeviceRequestResponse)

A response from the device after it processes the command to send requests to a device using lights-out management (LOM).



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)