apple_device-management/mdm/commands/profile.provisioning.install.yaml

title: Install Provisioning Profile Command
description: Install a provisioning profile on a device.
payload:
  requesttype: InstallProvisioningProfile
  supportedOS:
    iOS:
      introduced: '4.0'
      accessrights: AllowProvisioningInstallationRemoval
      supervised: false
      requiresdep: false
      sharedipad:
        mode: allowed
        devicechannel: true
        userchannel: false
      userenrollment:
        mode: allowed
    macOS:
      introduced: '11.0'
      accessrights: None
      devicechannel: true
      userchannel: false
      supervised: false
      requiresdep: false
      userenrollment:
        mode: allowed
    tvOS:
      introduced: '10.2'
      accessrights: AllowProvisioningInstallationRemoval
      supervised: false
    visionOS:
      introduced: '1.1'
      accessrights: AllowProvisioningInstallationRemoval
      supervised: false
      requiresdep: false
      userenrollment:
        mode: allowed
    watchOS:
      introduced: '10.0'
      accessrights: AllowProvisioningInstallationRemoval
      supervised: false
  content: This command allows the server to install a provisioning profile. No error
    occurs if the provisioning profile is already installed. This command requires
    the Provisioning Profile Installation and Removal right. On macOS, this command
    is for iOS and iPadOS style provisioning profiles only.
payloadkeys:
- key: ProvisioningProfile
  type: <data>
  presence: required
  content: The provisioning profile.
notes:
- title: ''
  content: |-
    No error occurs if the provisioning profile is already present.

    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/profile.provisioning.install/example1.plist
    response-file: examples/mdm/commands/profile.provisioning.install/example2.plist