Freigeben über


Get-AIPScannerStatus

Ruft den aktuellen Dienst status für den Azure Information Protection Scanner ab.

Syntax

Get-AIPScannerStatus []

Beschreibung

Dieses Cmdlet wird sowohl vom klassischen Azure Information Protection als auch von Clients für einheitliche Bezeichnungen mit unterschiedlicher Verwendung unterstützt, wie unten beschrieben.

Client für einheitliche Bezeichnungen

Das Cmdlet Get-AIPScannerStatus 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 verhindert, dass er Dateien überprüft. 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 findest du in den folgenden 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 noch nicht mit der Überprüfung des Repositorys begonnen hat
    • Überprüfung, wenn der aktuelle Scan im Repository ausgeführt wird
    • Abgeschlossen, wenn die aktuelle Überprüfung für das Repository ausgeführt wurde

Weitere Informationen finden Sie unter Überprüfen der Überprüfungsdetails pro Scannerknoten und Repository.

Beispiele

Beispiel 1: Abrufen der aktuellen status des Scannerdiensts (Client für einheitliche Bezeichnungen)

PS C:\> Get-AIPScannerStatus
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 gestartet wurde, am 03.10.2021 um 9:05:02 Uhr.

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

Beispiel 2: Verwenden Sie den Parameter Verbose, um Daten für den aktuellen Scan abzurufen (Client für einheitliche Bezeichnungen).

PS C:\> Get-AIPScannerStatus -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 (Client für einheitliche Bezeichnungen).

PS C:\> Get-AIPScannerStatus

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

Ein weiterer Drilldown mit der ganzzahligen Knoten zeigt eine lange Liste von Details zur Überprüfung 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 zum Drilldown auf Knotendetails verwenden, beginnen ganze Knotenzahlen mit 0.

Beispiel 4: Verwenden des Verbose-Parameters und der RepositoryStatus-Variable (Client für einheitliche Bezeichnungen)

PS C:\Windows\system32> $x=Get-AIPScannerStatus -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 zum derzeit ausgeführten Scan, einschließlich der Anzahl der gescannten, fehlerhaften, klassifizierten und beschrifteten Dateien sowie der Anzahl der gescannten Bytes.

Eingaben

None

Ausgaben

System.Object