macOS Disk Space (Query)

Use the Task Query macOS Disk Space to check the available disk space and folder space usage on Agents running on macOS. If you select to query a specific folder, this allows you to check the amount of space it uses and the size of the files it contains.

For example, you can use this Task to check the available disk space on a server at regular intervals, in order to prevent it from running out of disk space. You can also use the Task to check the size of the folder in which an application has been installed. You can set the Task Invoke Windows Installer to install the application automatically, depending on the outcome of the Query.


  • When querying on used folder space, you can specify the Start folder by clicking Browse button, by specifying the path to the folder manually or by using parameters and/or functions. You can specify parameters and functions manually or by right-clicking the Start folder field and clicking Insert Parameters or Insert Functions. See Parameters and Functions.
  • When setting an evaluator based on disk, you can use environment variables, parameters and functions to specify the disk. This is useful because mapped drive letters may vary per Agent. For example, if you use the environment variables %systemdrive%, the Agent that executes the Task will decide what drive to use.
  • When viewing the Job history of a Task Query Disk Space, select Show in KB to view the Job results of all Agents in KB. When a Task Query Disk Space is executed, the amount of free disk space of Agents can be reported in GB, in MB or in KB, depending on the amount of disk space that is available on each Agent. This makes it difficult to compare the Job history of multiple Agents when exported to a CSV file. The option Show in KB allows for an easy comparison in a CSV file.

If you schedule a recurring Job with this Task and view the results of this Job, the Job History tab in the detailed results window will display changes as they occur when comparing the query results with previous query results. Depending on the configuration of the query, this allows you to track changes in installed applications, printer drivers, services, shares, etc.