Mobile device configuration profiles are XML files (.mobileconfig) that provide an easy way to define settings and restrictions for mobile devices. The Casper Suite can be used to deploy mobile device configuration profiles to Apple TV devices with Apple TV software based on iOS 7 or later, or Apple TV devices with tvOS 10.2 or later.
The following configuration profile payloads are compatible with tvOS 10.2 or later:
Home Screen Layout (tvOS 11 or later)
Single App Mode
Global HTTP Proxy
Conference Room Display
AirPlay Security (tvOS 11 or later)
Note: A configuration profile containing both the iOS and tvOS selected options will be deployed to all devices in scope. Devices will ignore the restrictions that do not pertain to their device type.
For more information on creating or uploading a mobile device configuration profile, see Mobile Device Configuration Profiles in the Casper Suite Administrator's Guide.
Restrictions Payload Settings for Apple TV
The following restrictions are available for Apple TV devices with tvOS 10.2 or later through configuration profiles:
Allow AirPlay (supervised devices only)
Selecting Allow AirPlay prevents AirPlay on scoped tvOS devices. Scoped tvOS devices will not appear in a list of available devices when attempting to AirPlay on Apple TV.
Require passcode on first AirPlay pairing
You can select Require passcode on first AirPlay pairing for tvOS devices to require devices to provide the AirPlay password.
Note: Does not require tvOS 10.2 or later.
Allow control using Remote app
Selecting Allow control using Remote app prevents iOS devices from using the Remote app with Apple TV, and instead requires the use of a Siri Remote.
Note: This restriction does not prevent the use of the Siri Remote.
Allow keyboard continuation
Selecting Allow keyboard continuation prevents iOS keyboards from inputting text on Apple TV.
Allow modifying device name (tvOS 11 or later)
Media Content (tvOS 11 or later)
Restrict App Usage ( tvOS 11 or later, supervised only)
You can restrict app usage by creating an allowed or disallowed app list. When searching for apps to add to the list, the bundle ID can help differentiate between tvOS (e.g., com.apple.TVappname) and iOS (e.g., com.apple.appname) apps. Devices will ignore the bundle IDs that do not pertain to their device type.
Single App Mode Payload Settings for Apple TV
Beginning with tvOS 10.2, you can set supervised Apple TV devices to Single App Mode. Single App Mode locks scoped devices to a selected app. Apple TV devices in Single App Mode can still use AirPlay, unless restricted via the Restrictions payload. A device in Single App Mode that reboots will automatically resume locked screen display without first showing the Home Screen.
Note: Attempting to lock Apple TV devices to an in-house or third-party app that does not yet exist on the devices will cause an error. To avoid this issue, ensure the app is installed on scoped devices before configuring Single App Mode.
The following settings can be enforced when in Single App Mode:
When enforced, all touch input is disabled on the device including Siri Remote and any paired iOS devices.
When enforced, Auto-Lock is disabled, preventing the tvOS screen saver from appearing.
The following settings can be enforced or set to allow users to change when in Single App Mode:
Note: When enforced, these settings are disabled.
Conference Room Display Payload Settings for Apple TV
Beginning with tvOS 10.2, you can set supervised Apple TV devices to Conference Room Display mode using the JSS. Unless a background image and screen saver are manually defined in the Apple TV device settings, Conference Room Display locks scoped Apple TV devices to a black wallpaper screen and downloads a default screen saver. This mode can also display a message if configured.
Conference Room Display can be deployed automatically, and apps can install while devices are in this mode. A device set to Conference Room Display mode that reboots will automatically resume locked screen without first showing the Home Screen.
Note: If an Apple TV device is running Single App Mode, or if Single App Mode is deployed with Conference Room Display, Conference Room Display will override Single App Mode. In addition, if an Apple TV device is connected to a network via Ethernet, Conference Room Display will not automatically display a Wi-Fi network to join for AirPlay sharing. This can be manually added to the On-Screen Message field of the configuration profile in the Conference Room Display payload.
Home Screen Layout Payload Settings for Apple TV
Beginning with tvOS 11, you can configure the Home Screen Layout on supervised Apple TV devices using the JSS. The content of the Home Screen can now include applications and folders. They are displayed on the screen in the same order as defined in the configuration profile payload. Folders that exist on a device but are not defined in the payload will be removed when the profile is installed.
Note: If an application configured in the Home Screen Layout payload is not installed on a device, it will not display, or download and install automatically.
For related information, see the following sections of the Casper Suite Administrator's Guide:
Mobile Device Configuration Profiles
Learn about creating, uploading, and viewing mobile device configuration profiles.
Payload Capabilities for Mobile Device Configuration Profiles
Learn about the payload capabilities of each iOS and tvOS version.
"Viewing the Pending Management Commands for a Mobile Device" on the Viewing Management Information for a Mobile Device page
Find out how to view and cancel pending mobile device configuration profile installations and removals for a mobile device.
"Viewing Configuration Profiles for a Mobile Device" on the Viewing Management Information for a Mobile Device page
Find out how to view the mobile device configuration profiles in the scope for a mobile device.
"Viewing Management History for a Mobile Device" on the Viewing the History for a Mobile Device page
Find out how to view all completed, pending, and failed mobile device configuration profile installations and removals for a mobile device.