Discharge7443/fleet
1
0
Fork 0
Code Issues Pull Requests Actions 19 Packages Projects Releases Wiki Activity

Update OS settings documentation for clarity (#38837)

Browse Source 
Related to:

- #35738

---------

Co-authored-by: Noah Talerman <47070608+noahtalerman@users.noreply.github.com>
Co-authored-by: Jordan Montgomery <elijah.jordan.montgomery@gmail.com>
Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
This commit is contained in:
Marko Lisica
2026-02-16 10:52:12 +01:00
committed by GitHub
co-authored by Noah Talerman Jordan Montgomery Mike Thomas
parent 84c1c5fc44
commit 01f2ebcdf4
1 changed files with 5 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
articles/custom-os-settings.md
+5 -4
View File
@@ -77,7 +77,9 @@ If you want to make sure the profile stays device-scoped, update `PayloadScope`
In the Fleet UI, head to the **Controls > OS settings** tab.
In the top box, with "Verified," "Verifying," "Pending," and "Failed" statuses, click each status to view a list of hosts.
To see the status of a specific setting, hover over the setting's row in the **Custom settings** table and select the information (**i**) icon.
Currently, when editing a profile using Fleet's GitOps workflow, it can take 30 seconds for the profile's status to update to "Pending."
### Verified
@@ -107,10 +109,9 @@ Hosts that are running MDM commands or will run MDM commands to apply OS setting
Hosts that failed to apply OS settings. For Windows profiles, status codes are listed in [Microsoft's OMA DM docs](https://learn.microsoft.com/en-us/windows/client-management/oma-dm-protocol-support#syncml-response-status-codes).
In the list of hosts, click on an individual host and click the **OS settings** item to see the status for a specific setting.
macOS, iOS, or iPadOS hosts may display OS settings as "Failed" even when MDM is turned off. This can happen if MDM was previously enabled and the enrollment profile was deleted while the host was offline. Because Fleet never received [confirmation](https://developer.apple.com/documentation/devicemanagement/check-out) that the enrollment profile was removed, it continues sending MDM commands and checking their status, which always fails.
Currently, when editing a profile using Fleet's GitOps workflow, it can take 30 seconds for the
profile's status to update to "Pending."
To resolve this issue, turn MDM back on, then select **Actions > Turn off MDM** while the host is online.
### Special Windows behavior