title: LOM Setup Request Command
description: Get information from a device to set up lights-out management (LOM).
payload:
  requesttype: LOMSetupRequest
  supportedOS:
    iOS:
      introduced: n/a
    macOS:
      introduced: '11.0'
      accessrights: DeviceLockAndRemovePasscode
      devicechannel: true
      userchannel: false
      supervised: false
      requiresdep: false
      userenrollment:
        mode: forbidden
    tvOS:
      introduced: n/a
    visionOS:
      introduced: n/a
    watchOS:
      introduced: n/a
  content: Queries the device for LOM setup information such as IP addresses, protocol
    version, etc. The MDM server must send this command prior to sending the LOMDeviceRequest
    command.
responsekeys:
- key: PrimaryIPv6AddressList
  type: <array>
  presence: required
  content: An array that contains the IPv6 addresses for primary LOM-compatible Ethernet
    interfaces for the device.
  subkeys:
  - key: PrimaryIPv6AddressListItem
    type: <string>
    presence: required
- key: SecondaryIPv6AddressList
  type: <array>
  presence: required
  content: An array that contains the IPv6 addresses for secondary LOM-compatible
    Ethernet interfaces for the device.
  subkeys:
  - key: SecondaryIPv6AddressListItem
    type: <string>
    presence: required
- key: LOMProtocolVersion
  type: <integer>
  presence: required
  content: The LOM protocol version that the device supports.
notes:
- title: ''
  content: This command requires the `DeviceLockAndRemovePasscode` access right, `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).
examples:
- title: Example request and response
  files:
  - request-file: examples/mdm/commands/lom.setuprequest/example1.plist
    response-file: examples/mdm/commands/lom.setuprequest/example2.plist