# Using Parameters in Apple iOS/macOS Profiles Creating profiles with parameters in them is the ability to insert string/bool/int/datetime parameters into a profile so that they can be dynamically used on many devices. The following will help you understand what fields can be used, and what information will come from them. Remember: The below options are for FileWave's built in abilities. You can always create your own options by creating [**custom fields**](https://kb.filewave.com/books/custom-fields/page/custom-fields "Custom Fields") that are either mapped to LDAP attributes, custom scripts, or manually entered parameters. See [Custom Fields](https://kb.filewave.com/books/custom-fields/page/custom-fields "Custom Fields") for more information. ## What are my Options ## LDAP Parameters FileWave version 6.1 allows you to use Directory based parameters in your profile payloads.
%first\_name% %last\_name% %full\_name% %short\_name% %email% %job\_title% %mobile\_phone% %guid%
Setting up a directory server for use with Parameterized Profiles is easy. Navigate to the FileWave Preferences Screen and fill out the appropriate information for your OpenDirectory, Active Directory or E-Directory. For issues and troubleshooting related to your LDAP preferences, please refer to the [LDAP section](https://kb.filewave.com/books/filewave-central-anywhere/page/ldap-preferences "LDAP Preferences"). You must also be using LDAP authentication for iOS device enrollment. Instructions for that setup are in the [Using LDAP to enroll macOS/iOS/Android devices](https://kb.filewave.com/books/evaluation-guide/page/using-ldap-to-enroll-macosiosandroid-devices "Using LDAP to enroll macOS/iOS/Android devices").

For the above user strings to work you must be pointed to an Directory server and have it selected as authentication

You can also map custom fields to LDAP parameters to extend the above list. See [Custom Fields](https://kb.filewave.com/books/custom-fields/page/custom-fields "Custom Fields") for more information.

## Inventory / Device Parameters Starting in FileWave **6.1+** you can reference specific information about the device as well, directly from FileWave Inventory. Those fields are:
%OSVersion% %SerialNumber% %ProductName% %BuildVersion% %WIFIMAC% %ICCID% %IMEI%
## All Devices
Common Device Parameters Type FileWave Version Introduced
%archived% datetime 13.0.0
%auth\_username% string 13.0.0
%cpu\_count% int 13.0.0
%cpu\_type% string 13.0.0
%current\_ip\_address% string 13.0.0
%last\_enterprise\_app\_validation\_date% datetime 13.0.0
%last\_state\_change\_date% datetime 13.0.0
%department% string 13.0.0
%device\_id% string 13.0.0
%device\_name% string 13.0.0
%device\_product\_name% string 13.0.0
%enroll\_date% datetime 13.0.0
%filewave\_client\_name% string 13.0.0
%filewave\_id% string 13.0.0
%free\_disk\_space% int 13.0.0
%is\_system\_integrity\_protection\_enabled% bool 13.0.0
%is\_tracking\_enabled% bool 13.0.0
%last\_check\_in% datetime 13.0.0
%last\_ldap\_username% string 13.0.0
%last\_logged\_in\_username% string 13.0.0
%location% string 13.0.0
%management\_mode% int 13.0.0
%monitor\_id% string 13.0.0
%ram\_size% int 13.0.0
%serial\_number% string 13.0.0
%state% int 13.0.0
%total\_disk\_space% int 13.0.0
%unenrolled% bool 13.0.0
%is\_user\_enrollment% bool 13.2.0
%is\_activation\_lock\_manageable% bool 13.2.0
%remote\_desktop\_enabled% bool 13.2.0
%external\_boot\_level% bool 13.2.0
## Desktop Specific (macOS & Windows)
Desktop Device Parameters Type
%device\_manufacturer% string 13.0.0
%filewave\_client\_locked% bool 13.0.0
%filewave\_client\_version% string 13.0.0
%filewave\_model\_number% int 13.0.0
%rom\_bios\_version% string 13.0.0
## iOS Specific
iOS Device Parameters Type
%battery\_level% float (from 0 to 1) 13.0.0
%last\_cloud\_backup\_date% datetime 13.0.0
%last\_wallpaper\_change\_date% datetime 13.0.0
%apple\_device\_id% string 13.0.0
%eas\_device\_identifier% string 13.0.0
%is\_activation\_lock\_enabled% bool 13.0.0
%is\_device\_locator\_service\_enabled% bool 13.0.0
%is\_do\_not\_disturb\_in\_effect% bool 13.0.0
%is\_cloud\_backup\_enabled% bool 13.0.0
%is\_mdm\_lost\_mode\_enabled% bool 13.0.0
%is\_supervised% bool 13.0.0
%awaiting\_configuration% bool 13.0.0
%is\_network\_tethered% bool 13.0.0
%itunes\_store\_account\_is\_active% bool 13.0.0
%itunes\_store\_account\_hash% string 13.0.0
%languages% string 13.0.0
%locales% string 13.0.0
%maximum\_resident\_users% int 13.0.0
%meid% string 13.0.0
%model% string 13.0.0
%organization\_info% string 13.0.0
%product% string 13.0.0
%product\_name% string 13.0.0

You can also map custom fields to script results to extend the above list. See [Custom Fields](https://kb.filewave.com/books/custom-fields/page/custom-fields "Custom Fields") for more information.

You can also look in the inventory query builder and it will tell you the internal name in the bottom left: ![](https://kb.filewave.com/uploads/images/gallery/2023-07/4F26Y4L3crRdGfmj-embedded-image-yph2mvxb.png)
## Using parameters in profiles To add parameters to your profiles, simple replace the normal value with one from the list above. For instance, you might create an email profile with the account information. See the example here: ![Sample Profile](https://kb.filewave.com/uploads/images/gallery/2023-07/RPXWLT7uIa4Dofll-embedded-image-qz82u7gq.png) ## Appendix Directory servers use their own values for common fields. Below is the mapping for each supported directory: ## E-Directory
Profile Parameters LDAP attribute name Remarks
short\_name uid
first\_name givenName
last\_name sn
full\_name fullName
email mail
job\_title title
mobile\_phone mobile
guid GUID A binary read-only attribute
## Open Directory
Profile Parameters LDAP attribute name
email mail
first\_name givenName
full\_name fullName
guid apple-generateduid
job\_title title
last\_name sn
mobile\_phone mobile
short\_name uid
## Active Directory
Profile Parameters LDAP attribute name
email mail
first\_name givenName
full\_name fullName
guid objectGUID
job\_title title
last\_name sn
mobile\_phone mobile
short\_name sAMAccountName