Get-AIPScannerStatus

  • Reference
Modul:
AzureInformationProtection

Získá aktuální stav služby pro skener Azure Information Protection.

Syntax

Get-AIPScannerStatus []

Description

Tuto rutinu podporují klienti Azure Information Protection classic i unified labeling s různým využitím, jak je popsáno níže.

Klient sjednoceného popisování

Rutina Get-AIPScannerStatus vrátí následující podrobnosti o aktuálním stavu clusteru skeneru:

  • Název clusteru

  • Stav clusteru, včetně:

    • Offline: Služba není spuštěná.
    • Nečinná: Služba je spuštěná, ale momentálně neskenuje.
    • Kontrola: Služba je spuštěná a momentálně kontroluje soubory.
    • Chyba Služba skeneru je spuštěná, ale zjistila chybu, která jí brání ve skenování souborů. Služba například nemá přístup k databázi pro konfiguraci skeneru.

  • Čas spuštění kontroly: Čas, kdy byla poslední kontrola zahájena, ve formátu času UTC.

  • Čas od začátku: Doba prohledávání v následujícím formátu: Days.HH:MM:SS

  • Informace o uzlu: Seznam uzlů v clusteru skeneru

Pokud chcete získat další podrobnosti, použijte jednu nebo obě následující metody:

  • Pomocí proměnné NodesInfo můžete zobrazit podrobnosti o aktuálním stavu kontroly jednotlivých uzlů. Další informace najdete v následujících příkladech.

  • Pomocí parametru Verbose můžete zobrazit podrobnosti, jako je počet zkontrolovaných souborů, množství zkontrolovaných dat a podrobnosti pro každé zkontrolované úložiště.

    Při použití parametru Verbose přejděte k podrobnostem o úložištích pomocí proměnných RepositoriesStatus nebo CurrentScanSummary .

    Mezi možné stavy úložiště patří:

    • Přeskočeno, pokud došlo k přeskočení úložiště
    • Čeká na vyřízení, pokud aktuální kontrola ještě nezačala prohledávat úložiště
    • Kontrola, pokud je aktuální kontrola spuštěná v úložišti
    • Dokončeno, pokud se v úložišti dokončila aktuální kontrola.

Další informace najdete v tématu Ověření podrobností kontroly podle uzlu a úložiště skeneru.

Příklady

Příklad 1: Získání aktuálního stavu služby skeneru (klient sjednoceného popisování)

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}

Tento výstup ukazuje, že v clusteru je aktuálně spuštěná contoso-test kontrola, která byla spuštěna před 37 sekundami, v 03/10/2021 9:05:02 AM.

Výstup také ukazuje, že contoso-test cluster má 3 uzly.

Příklad 2: Použití parametru Verbose k získání dat pro aktuální kontrolu (klient sjednoceného popisování)

PS C:\> Get-AIPScannerStatus -Verbose

ScannedFiles    MBScanned    CurrentScanSummary                                         RepositoriesStatus
------------    ---------    ------------------                                         ------------------
        2280    78478187     Microsoft.InformationProtection.Scanner.ScanSummaryData    {​​​​​​{​​​​​​ Path = C:\temp, Status = Scanning }​​​​​​

Tento výstup zobrazuje pouze jedno úložiště. V případě více úložišť bude každé z nich uvedené samostatně.

Příklad 3: Použití proměnné NodesInfo k získání podrobností o stavu kontroly na jednotlivých uzlech (klient sjednoceného popisování)

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
....

Tento výstup nejprve zobrazí podrobnosti o aktuálním stavu kontroly, seznam uzlů v clusteru a potom podrobnosti o jednotlivých uzlech v tabulce.

Další přechod k podrobnostem pomocí celého čísla uzlu zobrazuje dlouhý seznam podrobností o kontrole na vybraném uzlu, například počet zkontrolovaných, klasifikovaných a označených souborů a počet zkontrolovaných bajtů.

Při použití proměnné NodesInfo k přechodu k podrobnostem o uzlu začínají celá čísla uzlů na 0.

Příklad 4: Použití parametru Verbose a proměnné RepositoriesStatus (klient sjednoceného popisování)

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

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

Výstup zobrazuje stav kontroly pro každé úložiště nakonfigurované pro úlohu kontroly obsahu.

Příklad 5: Použití parametru Verbose a proměnné CurrentScanSummary

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


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

Výstup zobrazuje další podrobnosti o aktuálně spuštěné kontrole, včetně počtu zkontrolovaných, neúspěšných, klasifikovaných a označených souborů a počtu zkontrolovaných bajtů.

Vstupy

None

Výstupy

System.Object