Get-AIPScannerStatus

  • Referentie
Module:
AzureInformationProtection

Hiermee haalt u de huidige servicestatus voor de Azure Information Protection-scanner op.

Syntax

Get-AIPScannerStatus []

Description

Deze cmdlet wordt ondersteund door zowel de klassieke Azure Information Protection als geïntegreerde labelclients, met verschillend gebruik, zoals hieronder wordt beschreven.

Client voor geïntegreerd labelen

De cmdlet Get-AIPScannerStatus retourneert de volgende details over de status van het huidige scannercluster:

  • Clusternaam

  • Clusterstatus, waaronder:

    • Offline: de service is niet gestart
    • Niet-actief: de service wordt uitgevoerd, maar wordt momenteel niet gescand
    • Scannen: de service wordt uitgevoerd en scant momenteel bestanden
    • Fout. De scannerservice wordt uitgevoerd, maar er is een fout opgetreden waardoor bestanden niet kunnen worden gescand. De service heeft bijvoorbeeld geen toegang tot de database voor de scannerconfiguratie.

  • Begintijd van scan: de tijd waarop de laatste scan is gestart, in UTC-tijdnotatie.

  • Tijd vanaf het begin: de scanduur, in de volgende indeling: Days.HH:MM:SS

  • Knooppuntgegevens: een lijst met de knooppunten in het scannercluster

Gebruik een of beide van de volgende methoden om meer informatie te verkrijgen:

  • Gebruik de variabele NodesInfo om details over de huidige scanstatus voor elk knooppunt weer te geven. Zie de onderstaande voorbeelden voor meer informatie.

  • Gebruik de parameter Uitgebreid om details weer te geven, zoals het aantal gescande bestanden, de hoeveelheid gescande gegevens en details voor elke gescande opslagplaats.

    Wanneer u de parameter Uitgebreid gebruikt, zoomt u verder in om meer details voor de opslagplaatsen te vinden met behulp van de variabelen RepositoriesStatus of CurrentScanSummary .

    Mogelijke statussen van opslagplaatsen zijn:

    • Overgeslagen als de opslagplaats is overgeslagen
    • In behandeling, als de huidige scan nog niet is gestart met het scannen van de opslagplaats
    • Scannen, als de huidige scan wordt uitgevoerd in de opslagplaats
    • Voltooid, als de huidige scan is voltooid, uitgevoerd op de opslagplaats

Zie Scangegevens per scannerknooppunt en opslagplaats verifiëren voor meer informatie.

Voorbeelden

Voorbeeld 1: de huidige status van de scannerservice ophalen (client voor geïntegreerd labelen)

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}

Deze uitvoer laat zien dat er momenteel een scan wordt uitgevoerd op het contoso-test cluster en 37 seconden geleden is gestart, op 03/10/2021 9:05:02 AM.

De uitvoer laat ook zien dat het contoso-test cluster 3 knooppunten heeft.

Voorbeeld 2: De parameter Uitgebreid gebruiken om gegevens op te halen voor de huidige scan (client voor geïntegreerde labels)

PS C:\> Get-AIPScannerStatus -Verbose

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

Deze uitvoer toont slechts één opslagplaats. In het geval van meerdere opslagplaatsen wordt elke opslagplaats afzonderlijk vermeld.

Voorbeeld 3: De variabele NodesInfo gebruiken om details op te halen over de scanstatus op elk knooppunt (client voor geïntegreerde labels)

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 deze uitvoer worden eerst details weergegeven over de huidige scanstatus, evenals een lijst met knooppunten in het cluster en vervolgens details voor elk knooppunt in een tabel.

Verder inzoomen met behulp van het gehele knooppunt toont een lange lijst met details over de scan op het geselecteerde knooppunt, zoals het aantal gescande, geclassificeerde en gelabelde bestanden, evenals het aantal gescande bytes.

Wanneer u de variabele NodesInfo gebruikt om in te zoomen op knooppuntdetails, beginnen gehele knooppunten met 0.

Voorbeeld 4: de parameter Uitgebreid en de variabele RepositoriesStatus (client voor geïntegreerde labels) gebruiken

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

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

De uitvoer toont de scanstatus voor elke opslagplaats die is geconfigureerd voor de inhoudsscantaak.

Voorbeeld 5: de parameter Verbose en de variabele CurrentScanSummary gebruiken

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


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

In de uitvoer ziet u meer informatie over de scan die momenteel wordt uitgevoerd, waaronder het aantal gescande, mislukte, geclassificeerde en gelabelde bestanden, evenals het aantal gescande bytes.

Invoerwaarden

None

Uitvoerwaarden

System.Object