Get-AIPScannerStatus

  • Referens
Modul:
AzureInformationProtection

Hämtar den aktuella tjänststatusen för Azure Information Protection-skannern.

Syntax

Get-AIPScannerStatus []

Description

Den här cmdleten stöds av både Azure-Information Protection klassiska och enhetliga etiketteringsklienter, med olika användning, enligt beskrivningen nedan.

Enhetlig etiketteringsklient

Cmdleten Get-AIPScannerStatus 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 har uppstått 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 nedan.

  • 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 ännu inte har börjat genomsöka lagringsplatsen
    • Genomsökning, om den aktuella genomsökningen körs på lagringsplatsen
    • Slutförd, om den aktuella genomsökningen har slutfö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 (klienten för enhetlig etikettering)

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}

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

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

Exempel 2: Använd den utförliga parametern för att hämta data för den aktuella genomsökningen (enhetlig etiketteringsklient)

PS C:\> Get-AIPScannerStatus -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 (enhetlig etiketteringsklient)

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

Utdata visar först information om aktuell genomsökningsstatus samt 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 samt 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 (unified labeling client)

PS C:\Windows\system32> $x=Get-AIPScannerStatus -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 samt antalet genomsökda byte.

Indata

None

Utdata

System.Object