Get-ScanStatus
Gets the current status of the service for the Microsoft Purview Information Protection scanner.
Syntax
Default (Default)
Get-ScanStatus
Description
The Get-ScanStatus cmdlet returns the following details about the current scanner cluster status:
Cluster name
Cluster status, including:
- Offline: The service isn't started
- Idle: The service is running but not currently scanning
- Scanning: The service is running and is currently scanning files
- Error. The scanner service is running but it encountered an error that prevents it from scanning files. For example, the service can't access the database for the scanner configuration.
Scan start time: The time the last scan started, in UTC time format.
Time from start: The scanning duration, in the following format:
Days.HH:MM:SSNode information: A list of the nodes in the scanner cluster
To obtain further details, use one or both of the following methods:
Use the NodesInfo variable to view details about the current scanning status for each node. For more information, see the examples.
Use the Verbose parameter to view details such as the number of scanned files, amount of data scanned, and details for each repository scanned.
When using the Verbose parameter, drill down further to find more details for the repositories by using the RepositoriesStatus or the CurrentScanSummary variables.
Possible repository statuses include:
- Skipped, if the repository was skipped
- Pending, if the current scan isn't started scanning the repository
- Scanning, if the current scan is running on the repository
- Finished, if the current scan finished running on the repository
For more information, see Verify scanning details per scanner node and repository.