# directoryservices.cache_refresh

This method refreshes the directory services cache for users and groups that is used as a backing for user.query and group.query methods. The first cache fill in an Active Directory domain may take a significant amount of time to complete and so it is performed as within a job. The most likely situation in which a user may desire to refresh the directory services cache is after new users or groups to a remote directory server with the intention to have said users or groups appear in the results of the aforementioned account-related methods.

A cache refresh is not required in order to use newly-added users and groups for in permissions and ACL related methods. Likewise, a cache refresh will not resolve issues with users being unable to authenticate to shares.

This method is a job.

Type: object

##

Type: array
No Additional Items

##

#### Result

Type: null

Required roles: DIRECTORY_SERVICE_WRITE