Cellular Private Network
com.apple.cellularprivatenetwork.managed
The payload that provides device info on private network deployments, including geographical location, preference over Wi-Fi, and network deployment type.
iOS 17.0+
Apple schemaNot available with User Enrollment
Configuration Keys (7)
| Key | Type | Description | Default | Range |
|---|---|---|---|---|
Geofencesarray | array | A list of up to 1000 geofences for private networks. Geofencing is only used on iPhone. | Default: — | Range: — |
GeofenceItemdict | dict | A geofence for a private network. | Default: — | Range: — |
Longituderealrequired | real | The longitude of the geofence. | Default: — | Range: -180 – 180 |
Latituderealrequired | real | The latitude of the geofence. | Default: — | Range: -90 – 90 |
Radiusrealrequired | real | Specifies the radius of the geofence in meters. Set this value slightly greater than the private cellular network coverage area. | Default: — | Range: 100 – 6500 |
GeofenceIdstringrequired | string | A geofence identifier that's unique within a list of geofences. | Default: — | Range: — |
DataSetNamestringrequired | string | The name of the private network configuration data set. | Default: — | Range: — |
VersionNumberstringrequired | string | The version number of this dataset that the system uses to track updates. | Default: — | Range: — |
CellularDataPreferredboolean | boolean | Set to 'true' to prefer this private network over Wi-Fi. | Default: false | Range: — |
EnableNRStandaloneboolean | boolean | Set to 'true' if this private network is NR Standalone. | Default: false | Range: — |
NetworkIdentifierstringiOS 18.0+ | string | A string using the 3GPP "Coordinated NID" (option 1 or option 2) format (defined in 3GPP 31.102, Section 12.7.1). The device uses this value to match a SIM present on the device. All combinations of 'NetworkIdentifier' and 'CsgNetworkIdentifier' must be unique across all profiles installed on the device. | Default: — | Range: — |
CsgNetworkIdentifierstringiOS 18.0+ | string | A string using the 3GPP "CSG_ID" format (defined in 3GPP 23.003, Section 4.7). The device uses this value to match a SIM present on the device. All combinations of 'NetworkIdentifier' and 'CsgNetworkIdentifier' must be unique across all profiles installed on the device. | Default: — | Range: — |