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>
Scriptable commands
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 |
|---|---|---|
| Always available |
Pinned |
/Applications/OneDrive.App/Contents/MacOS/OneDrive /pin <path> |
| Locally available |
Clearpin |
/Applications/OneDrive.App/Contents/MacOS/OneDrive /clearpin <path> |
| Online-only |
Unpinned |
/Applications/OneDrive.App/Contents/MacOS/OneDrive /unpin <path> |
Note
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."
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for