mirror of
https://github.com/apple/device-management.git
synced 2026-07-10 21:13:42 +02:00
Cyrus Daboo
63 lines
2.1 KiB
YAML
63 lines
2.1 KiB
YAML
title: NSExtension Mappings Command
|
|
description: Get a list of the installed extensions for a user on a device.
|
|
payload:
|
|
requesttype: NSExtensionMappings
|
|
supportedOS:
|
|
iOS:
|
|
introduced: n/a
|
|
macOS:
|
|
introduced: '10.13'
|
|
accessrights: QueryInstalledApps
|
|
devicechannel: false
|
|
userchannel: true
|
|
supervised: false
|
|
requiresdep: false
|
|
userenrollment:
|
|
mode: forbidden
|
|
tvOS:
|
|
introduced: n/a
|
|
visionOS:
|
|
introduced: n/a
|
|
watchOS:
|
|
introduced: n/a
|
|
content: |-
|
|
This command returns information about installed extensions for a user.
|
|
The purpose of this command is to allow the server to build a mapping of
|
|
extension identifiers to extension points to provide a UI for generating
|
|
"com.apple.NSExtension" payloads.
|
|
Requires "Query Installed Apps" right; supported on user channel only
|
|
responsekeys:
|
|
- key: Extensions
|
|
type: <array>
|
|
presence: required
|
|
content: An array of dictionaries that contains information about extensions on
|
|
the device.
|
|
subkeys:
|
|
- key: ExtensionsItem
|
|
type: <dictionary>
|
|
content: A dictionary that contains information about an extension.
|
|
subkeys:
|
|
- key: Identifier
|
|
type: <string>
|
|
presence: required
|
|
content: The identifier of the extension.
|
|
- key: ExtensionPoint
|
|
type: <string>
|
|
presence: required
|
|
content: The `NSExtensionPointIdentifier` for the extension.
|
|
- key: DisplayName
|
|
type: <string>
|
|
presence: required
|
|
content: The display name of the extension.
|
|
notes:
|
|
- title: ''
|
|
content: |-
|
|
This list is a superset of the list that `ActiveNSExtensionsCommand` returns. It may contain extensions that the system never enables due to various restrictions.
|
|
|
|
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/application.extensions.mappings/example1.plist
|
|
response-file: examples/mdm/commands/application.extensions.mappings/example2.plist
|