Files
apple_device-management/mdm/commands/system.update.scan.yaml
Cyrus Daboo 97a11a861f Seed2
2026-06-22 15:55:19 -04:00

49 lines
1.4 KiB
YAML

title: Schedule OS Update Scan Command
description: 'Schedule a background scan for operating-system updates on a device.
Removed: use the declarative management `com.apple.configuration.softwareupdate.enforcement.specific`
configuration.'
payload:
requesttype: ScheduleOSUpdateScan
supportedOS:
iOS:
introduced: n/a
macOS:
introduced: '10.11'
deprecated: '26.0'
removed: '27.0'
accessrights: None
devicechannel: true
userchannel: false
supervised: true
requiresdep: false
userenrollment:
mode: forbidden
tvOS:
introduced: n/a
visionOS:
introduced: n/a
watchOS:
introduced: n/a
content: Requests that the device perform a background scan for OS updates.
payloadkeys:
- key: Force
type: <boolean>
presence: optional
default: false
content: If `true`, force a scan to start immediately. Otherwise, the scan starts
at a system-determined time.
responsekeys:
- key: ScanInitiated
type: <boolean>
presence: required
content: If `true`, the scan started successfully.
notes:
- title: ''
content: Refer to the following sections to determine supported channels and requirements,
and to see an example request and response.
examples:
- title: Example request and response
files:
- request-file: examples/mdm/commands/system.update.scan/example1.plist
response-file: examples/mdm/commands/system.update.scan/example2.plist