Skip to content

Guides: Add DeviceConfigured example to Setup Experience guide #50560

Description

@GrayW

If a host becomes stuck during setup experience, the guide (https://fleetdm.com/guides/setup-experience#advanced:~:text=If%20a%20host%20gets%20stuck) provides a suggestion on sending an MDM command to release it from the setup early.

If a host gets stuck, you can send the DeviceConfigured command using Fleet's Run MDM command API to let the end user through.

We should add an example here, along with how to use it through fleetctl and the API. Avoiding any assumption of understanding or knowledge.

This will ensure a more complete guide, and a better experience for the customer, reducing frustration from having to figure it out during an issue.

<?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>RequestType</key>
        <string>DeviceConfigured</string>
    </dict>
    <key>CommandUUID</key>
    <string>REPLACE-WITH-A-UUID</string>
</dict>
</plist>
fleetctl mdm run-command --hosts <hostname-or-serial-or-uuid> --payload <path-to-plist>
POST /api/v1/fleet/commands/run

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

:help-customersCustomer success issue.:improve documentationInvolves writing improvements or additions to documentation

Type

No type

Projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions