Query and set Files On-Demand states on Mac
With OneDrive Files On-Demand, files can be in one of three states. Each of these states corresponds to a file attribute state. To query the current state of a file or folder, use the following command:
- /Applications/OneDrive.App/Contents/MacOS/OneDrive /getpin <Path to file or folder>
Use the following commands to set file and folder states. Quit the OneDrive sync app before running these commands.
|Files On-Demand state||File attribute state||Command|
||/Applications/OneDrive.App/Contents/MacOS/OneDrive /pin <path>
||/Applications/OneDrive.App/Contents/MacOS/OneDrive /clearpin <path>|
||/Applications/OneDrive.App/Contents/MacOS/OneDrive /unpin <path>|
To set the file attribute state for all items within a folder, add the /r parameter.
Pinning an online-only file makes the sync app download the file contents, and unpinning a downloaded file frees up space on the device by not storing the file contents locally.
To set an online-only file or folder to "locally available," you must first set it to "always available."