Get-ScanStatus

Modul:: PurviewInformationProtection

Ruft den aktuellen 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 Status des Scannerclusters zurück:

Clustername
Clusterstatus, einschließlich:
- Offline: Der Dienst wurde nicht gestartet
- Leerlauf: Der Dienst wird ausgeführt, scannt aber derzeit nicht
- Scannen: Der Dienst wird ausgeführt und scannt 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.
Startzeit des Scans: Der Zeitpunkt, zu dem der letzte Scan gestartet wurde, im UTC-Zeitformat.
Zeit ab Start: Die Scandauer im folgenden Format: Days.HH:MM:SS
Knoteninformationen: Eine Liste der Knoten im Scanner-Cluster

Um weitere Details zu erhalten, verwenden Sie eine oder beide der folgenden Methoden:

Verwenden Sie die Variable NodesInfo, um Details zum aktuellen Scanstatus für jeden Knoten anzuzeigen. Weitere Informationen finden Sie in den Beispielen.
Verwenden Sie den Parameter Ausführlich , um Details wie die Anzahl der gescannten Dateien, die Menge der gescannten Daten und Details für jedes gescannte Repository anzuzeigen.

Wenn Sie den Parameter "Ausführlich" verwenden, führen Sie mithilfe der Variablen "RepositoryStatus" oder " CurrentScanSummary " einen weiteren Drilldown durch, um weitere Details für die Repositorys zu erhalten.

Mögliche Repository-Status sind:
- Übersprungen, wenn das Repository übersprungen wurde
- Ausstehend, wenn der aktuelle Scan nicht gestartet wird, um das Repository zu scannen
- Scannen, wenn der aktuelle Scan im Repository ausgeführt wird
- Abgeschlossen, wenn die Ausführung des aktuellen Scans im Repository abgeschlossen ist

Weitere Informationen finden Sie unter Überprüfen von Scandetails pro Scannerknoten und Repository.

Beispiele

Beispiel 1: Abrufen des 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 eine Überprüfung auf dem contoso-test Cluster ausgeführt wird und vor 37 Sekunden, am 10. März 2021 um 9:05:02 Uhr, gestartet wurde.

Die Ausgabe zeigt auch, dass der contoso-test Cluster über drei Knoten verfügt.

Beispiel 2: Verwenden des Parameters "Ausführlich" 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 Repositories wird jedes Repository separat aufgeführt.

Beispiel 3: Verwenden der Variablen "NodesInfo" zum Abrufen von Details zum Scanstatus auf den einzelnen Knoten

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 Überprüfungsstatus und eine Liste der Knoten im Cluster und dann Details zu jedem Knoten in einer Tabelle angezeigt.

Ein weiterer Drilldown mit der Knoten-Ganzzahl zeigt eine lange Liste von Details zum Scan auf dem ausgewählten Knoten, z. B. die Anzahl der gescannten, klassifizierten und beschrifteten Dateien sowie die Anzahl der gescannten Bytes.

Wenn Sie die NodesInfo-Variable verwenden, um einen Drilldown zu Knotendetails durchzuführen, beginnen Knotenganzzahlen mit 0.

Beispiel 4: Verwenden des Parameters "Ausführlich" und der Variablen "RepositoriesStatus"

PS C:\Windows\system32> $x=Get-ScanStatus - Verbose
PS C:\Windows\system32> $x.RepositoriesStatus

Path        Status
----        ------
C:\temp     Scanning

Die Ausgabe zeigt den Scanstatus für jedes Repository an, das für den Inhaltsscanauftrag konfiguriert ist.

Beispiel 5: Verwenden des Parameters "Verbose" und der Variablen "CurrentScanSummary"

PS C:\Windows\system32> $x.CurrentScanSummary


ScannerID               : 
ScannedFiles            : 2280
FailedFiles             : 0
ScannedBytes            : 78478187
Classified              : 0
Labeled                 : 0
....

Die Ausgabe enthält weitere Details zum aktuell ausgeführten Scan, einschließlich der Anzahl der gescannten, fehlgeschlagenen, klassifizierten und bezeichneten Dateien sowie der Anzahl der gescannten Bytes.

Eingaben

None

Ausgaben

System.Object

Freigeben über