Skip to main content

Bulk Update the iOS Enrollment User (auth_username) and Client Name using API

What

The api_UpdateiPadNameandAuthUser script is a tool that allows FileWave admins to update the names and assigned users of multiple iOS devices in bulk, using a CSV file containing the serial numbers, desired device names, and LDAP usernames of the devices. This can be particularly useful for education organizationsorganizations, but may also be useful for others who do mass re-distributions of devices like iPads.

When/Why

If you need to quickly and easily reassign a large number of iPads to different users, the api_UpdateiPadNameandAuthUser script can save you time and effort. Instead of manually updating each device individually, you can simply prepare a CSV file with the necessary information and use the script to apply the changes to all of the devices at once. This can be especially useful when you need to set up a large number of new devices for use by different users or when you need to make changes to the assignments of existing devices.

How

To use the api_UpdateiPadNameandAuthUser script, you will need to follow the instructions in the README file that accompanies the script:

  1. Download the zip file that contains the script and the README.

    Download: api_UpdateiPadNameANDAuthUser_v2.zip

  2. Edit the CSV file to contain a list of serial numbers, device names, and LDAP usernames for the devices you want to update.
  3. Open Terminal (on a Mac or Linux) and navigate to the directory that contains the script and CSV file.
  4. Make the script executable by running the following command

    chmod +x ./api_UpdateiPadNameandAuthUser.sh.sh

  5. Run the script using the commandfollowing command, replacing the parameters, leaving only spaces in between.

    ./api_UpdateiPadNameandAuthUser.sh <SERVER TOKENURL> CSVFILE,<BASE64TOKEN> replacing<PATH SERVERTO withCSVFILE>
    theParameters: name
    of
  6. <Server yourURL>: Your FileWave server,Anywhere address. For example, https://server.filewave.com
<BASE64 TOKEN>: withThe your FileWavebase64 API token, andfound in FileWave Admin under Assistants > Manage Administrators > (select a username) > Application Tokens > Token (base64). For example, 

ezcyMjczOTQyLTc1YjctNDFmMC1iYTlhLTE1MWM3OThiOWFhMH0=

<PATH TO CSVFILE>: withThe thefull path to the CSV.csv filefile. youFor preparedexample, in/Users/admin/Desktop/api_UpdateiPadNameandAuthUser.csv
step 2.

The script's output will show you the progress of the updates and will indicate when the process is complete.

If you are running into an issue where the script says that it completed and is Updating ModelModel, but no changes are made -made, please add a blank line at the end of your .csv, save itit, and try the command again.

Back to top