Get-ScanStatus

  • Referenz
Modul:
PurviewInformationProtection

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