Get-ScanStatus
Ruft die aktuelle status des Diensts für den Microsoft Purview Information Protection-Scanner ab.
Syntax
Get-ScanStatus []
Beschreibung
Das Cmdlet Get-ScanStatus gibt die folgenden Details zum aktuellen Scannercluster status zurück:
Clustername
Cluster-status, einschließlich:
- Offline: Der Dienst wurde nicht gestartet
- Leerlauf: Der Dienst wird ausgeführt, aber derzeit nicht überprüft.
- Überprüfung: Der Dienst wird ausgeführt und überprüft derzeit Dateien.
- Fehler. Der Scannerdienst wird ausgeführt, aber es ist ein Fehler aufgetreten, der das Scannen von Dateien verhindert. Beispielsweise kann der Dienst nicht auf die Datenbank für die Scannerkonfiguration zugreifen.
Scanstartzeit: Der Zeitpunkt, zu dem der letzte Scan gestartet wurde, im UTC-Zeitformat.
Zeit vom Anfang: Die Überprüfungsdauer im folgenden Format:
Days.HH:MM:SS
Knoteninformationen: Eine Liste der Knoten im Scannercluster
Verwenden Sie eine oder beide der folgenden Methoden, um weitere Details zu erhalten:
Verwenden Sie die NodesInfo-Variable, um Details zum aktuellen Scan-status für jeden Knoten anzuzeigen. Weitere Informationen finden Sie in den Beispielen.
Verwenden Sie den Verbose-Parameter , um Details wie die Anzahl der gescannten Dateien, die gescannte Datenmenge und Details für jedes überprüfte Repository anzuzeigen.
Wenn Sie den Verbose-Parameter verwenden, finden Sie weitere Details zu den Repositorys mithilfe der RepositorysStatus - oder CurrentScanSummary-Variablen .
Mögliche Repositorystatus sind:
- Übersprungen, wenn das Repository übersprungen wurde
- Ausstehend, wenn der aktuelle Scan nicht gestartet wurde, wird das Repository überprüft.
- Überprüfung, wenn der aktuelle Scan im Repository ausgeführt wird
- Abgeschlossen, wenn die aktuelle Überprüfung für das Repository abgeschlossen wurde
Weitere Informationen finden Sie unter Überprüfen der Überprüfungsdetails pro Scannerknoten und Repository.
Beispiele
Beispiel 1: Abrufen der aktuellen status des Scannerdiensts
PS C:\> Get-ScanStatus
Cluster : contoso-test
ClusterStatus : Scanning
StartTime : 03/10/2021 9:05:02 AM
TimeFromStart : 00:00:00:37
NodesInfo : {t-contoso1-T298-corp.contoso.com,t-contoso2-T298-corp.contoso.com,t-contoso3-T298-corp.contoso.com}
Diese Ausgabe zeigt, dass derzeit ein Scan auf dem contoso-test
Cluster ausgeführt wird und vor 37 Sekunden gestartet wurde, am 10. März 2021 um 9:05:02 Uhr.
Die Ausgabe zeigt auch, dass der contoso-test
Cluster über drei Knoten verfügt.
Beispiel 2: Verwenden des Parameters "Verbose" zum Abrufen von Daten für den aktuellen Scan
PS C:\> Get-ScanStatus -Verbose
ScannedFiles MBScanned CurrentScanSummary RepositoriesStatus
------------ --------- ------------------ ------------------
2280 78478187 Microsoft.InformationProtection.Scanner.ScanSummaryData {{ Path = C:\temp, Status = Scanning }
Diese Ausgabe zeigt nur ein einzelnes Repository an. Bei mehreren Repositorys wird jedes einzeln aufgelistet.
Beispiel 3: Verwenden sie die NodesInfo-Variable, um Details zum Scan-status auf jedem Knoten abzurufen.
PS C:\> Get-ScanStatus
Cluster : contoso-test
ClusterStatus : Scanning
StartTime : 12/22/2020 9:05:02 AM
TimeFromStart : 00:00:00:37
NodesInfo : {t-contoso1-T298-corp.contoso.com,t-contoso2-T298-corp.contoso.com}
PS C:\WINDOWS\system32> $x=Get-ScanStatus
PS C:\WINDOWS\system32> $x.NodesInfo
NodeName Status IsScanning Summary
-------- -------- ---------- -------
t-contoso1-T298-corp.contoso.com Scanning True Microsoft.InformationProtection.Scanner.ScanSummaryData
t-contoso2-T298-corp.contoso.com Scanning Pending Microsoft.InformationProtection.Scanner.ScanSummaryData
PS C:\Windows\system32> $x.NodesInfo[0].Summary
ScannerID : t-contoso1-T298-corp.contoso.com
ScannedFiles : 2280
FailedFiles : 0
ScannedBytes : 78478187
Classified : 0
Labeled : 0
....
In dieser Ausgabe werden zunächst Details zum aktuellen Scan-status und einer Liste der Knoten im Cluster und dann Details zu jedem Knoten in einer Tabelle angezeigt.
Ein weiterer Drilldown mit der Ganzzahl des Knotens zeigt eine lange Liste von Details zur Überprüfung auf dem ausgewählten Knoten, z. B. die Anzahl der gescannten, klassifizierten und beschrifteten Dateien und die Anzahl der gescannten Bytes.
Wenn Sie die NodesInfo-Variable zum Drilldown auf Knotendetails verwenden, beginnen ganze Knotenzahlen mit 0.
Beispiel 4: Verwenden des Verbose-Parameters und der RepositoryStatus-Variablen
PS C:\Windows\system32> $x=Get-ScanStatus - Verbose
PS C:\Windows\system32> $x.RepositoriesStatus
Path Status
---- ------
C:\temp Scanning
Die Ausgabe zeigt den Scan-status für jedes Repository an, das für den Inhaltsüberprüfungsauftrag konfiguriert ist.
Beispiel 5: Verwenden des Verbose-Parameters und der Variablen CurrentScanSummary
PS C:\Windows\system32> $x.CurrentScanSummary
ScannerID :
ScannedFiles : 2280
FailedFiles : 0
ScannedBytes : 78478187
Classified : 0
Labeled : 0
....
Die Ausgabe zeigt weitere Details zur derzeit ausgeführten Überprüfung, einschließlich der Anzahl der gescannten, fehlerhaften, klassifizierten und beschrifteten Dateien und der Anzahl der gescannten Bytes.
Eingaben
None
Ausgaben
System.Object