Get-ScanStatus

  • Referens
Modul:
PurviewInformationProtection

Hämtar den aktuella statusen för tjänsten för Microsoft Purview Information Protection-skannern.

Syntax

Get-ScanStatus []

Description

Cmdleten Get-ScanStatus returnerar följande information om aktuell status för skannerklustret:

  • Klusternamn

  • Klusterstatus, inklusive:

    • Offline: Tjänsten har inte startats
    • Inaktiv: Tjänsten körs men genomsöker inte för närvarande
    • Genomsökning: Tjänsten körs och söker just nu igenom filer
    • Fel. Skannertjänsten körs men det påträffades ett fel som förhindrar att den genomsöker filer. Tjänsten kan till exempel inte komma åt databasen för skannerkonfigurationen.

  • Genomsökningens starttid: Den tid då den senaste genomsökningen startade, i UTC-tidsformat.

  • Tid från start: Genomsökningens varaktighet i följande format: Days.HH:MM:SS

  • Nodinformation: En lista över noderna i skannerklustret

Om du vill få mer information använder du en eller båda av följande metoder:

  • Använd variabeln NodesInfo för att visa information om den aktuella genomsökningsstatusen för varje nod. Mer information finns i exemplen.

  • Använd den utförliga parametern för att visa information, till exempel antalet skannade filer, mängden data som genomsöks och information för varje genomsökt lagringsplats.

    När du använder verbose-parametern ökar du detaljnivån ytterligare för att hitta mer information om lagringsplatserna med hjälp av variablerna RepositoriesStatus eller CurrentScanSummary .

    Möjliga lagringsplatsstatusar är:

    • Hoppas över, om lagringsplatsen hoppades över
    • Väntar, om den aktuella genomsökningen inte har startats genomsökning av lagringsplatsen
    • Genomsökning, om den aktuella genomsökningen körs på lagringsplatsen
    • Slutförd, om den aktuella genomsökningen har körts på lagringsplatsen

Mer information finns i Verifiera genomsökningsinformation per skannernod och lagringsplats.

Exempel

Exempel 1: Hämta den aktuella statusen för skannertjänsten

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}

De här utdata visar att en genomsökning för närvarande körs i contoso-test klustret och startades för 37 sekunder sedan, den 10 mars 2021 kl. 09:05:02.

Utdata visar också att klustret contoso-test har tre noder.

Exempel 2: Använd parametern Verbose för att hämta data för den aktuella genomsökningen

PS C:\> Get-ScanStatus -Verbose

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

Dessa utdata visar endast en enda lagringsplats. Om det finns flera lagringsplatser visas var och en separat.

Exempel 3: Använd variabeln NodesInfo för att få information om genomsökningsstatusen på varje nod

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

Dessa utdata visar först information om den aktuella genomsökningsstatusen och en lista över noder i klustret och sedan information om varje nod i en tabell.

Ytterligare detaljvisning med nod-heltal visar en lång lista med information om genomsökningen på den valda noden, till exempel antalet skannade, klassificerade och märkta filer och antalet genomsökta byte.

När du använder variabeln NodesInfo för att öka detaljnivån för nodinformation börjar nod heltal med 0.

Exempel 4: Använd verbose-parametern och variabeln RepositoriesStatus

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

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

Utdata visar genomsökningsstatusen för varje lagringsplats som konfigurerats för innehållsgenomsökningsjobbet.

Exempel 5: Använd parametern Verbose och variabeln CurrentScanSummary

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


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

Utdata visar ytterligare information om den genomsökning som för närvarande körs, inklusive antalet skannade, misslyckade, klassificerade och märkta filer och antalet genomsökda byte.

Indata

None

Utdata

System.Object