Condividi tramite

Get-ScanStatus

  • Riferimento
Modulo:
PurviewInformationProtection

Ottiene lo stato corrente del servizio per lo scanner Microsoft Purview Information Protection.

Sintassi

Get-ScanStatus []

Descrizione

Il cmdlet Get-ScanStatus restituisce i dettagli seguenti sullo stato del cluster dello scanner corrente:

  • Nome cluster

  • Stato del cluster, tra cui:

    • Offline: il servizio non viene avviato
    • Inattività: il servizio è in esecuzione, ma non è attualmente in esecuzione l'analisi
    • Analisi: il servizio è in esecuzione ed è attualmente in fase di analisi dei file
    • Errore. Il servizio scanner è in esecuzione, ma ha rilevato un errore che impedisce l'analisi dei file. Ad esempio, il servizio non può accedere al database per la configurazione dello scanner.

  • Ora di inizio analisi: ora dell'ultima analisi avviata, in formato ora UTC.

  • Ora dall'inizio: durata dell'analisi nel formato seguente: Days.HH:MM:SS

  • Informazioni sul nodo: elenco dei nodi nel cluster scanner

Per ottenere altri dettagli, usare uno o entrambi i metodi seguenti:

  • Usare la variabile NodeInfo per visualizzare i dettagli sullo stato di analisi corrente per ogni nodo. Per altre informazioni, vedere gli esempi.

  • Usare il parametro Verbose per visualizzare i dettagli, ad esempio il numero di file analizzati, la quantità di dati analizzati e i dettagli per ogni repository analizzato.

    Quando si usa il parametro Verbose, eseguire il drill-down ulteriormente per trovare altri dettagli per i repository usando repositoryStatus o le variabili CurrentScanSummary .

    Gli stati del repository possibili includono:

    • Ignorato, se il repository è stato ignorato
    • In sospeso, se l'analisi corrente non viene avviata l'analisi del repository
    • Analisi, se l'analisi corrente è in esecuzione nel repository
    • Completato, se l'analisi corrente è stata completata in esecuzione nel repository

Per altre informazioni, vedere Verificare i dettagli di analisi per nodo dello scanner e il repository.

Esempio

Esempio 1: Ottenere lo stato corrente del servizio scanner

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}

Questo output mostra che un'analisi è attualmente in esecuzione nel contoso-test cluster ed è stata avviata 37 secondi fa, il 10 marzo 2021 alle 9:05:02.

L'output mostra anche che il contoso-test cluster ha tre nodi.

Esempio 2: Usare il parametro dettagliato per ottenere dati per l'analisi corrente

PS C:\> Get-ScanStatus -Verbose

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

Questo output mostra solo un singolo repository. Nei casi di più repository, ognuno è elencato separatamente.

Esempio 3: Usare la variabile NodeInfo per ottenere informazioni dettagliate sullo stato di analisi in ogni nodo

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

Questo output visualizza prima i dettagli sullo stato di analisi corrente e un elenco di nodi nel cluster e quindi i dettagli per ogni nodo, in una tabella.

Ulteriori drill-down usando l'intero del nodo mostrano un elenco lungo di dettagli sull'analisi sul nodo selezionato, ad esempio il numero di file analizzati, classificati ed etichettati e il numero di byte analizzati.

Quando si usa la variabile NodeInfo per eseguire il drill-down sui dettagli del nodo, i numeri interi dei nodi iniziano con 0.

Esempio 4: Usare il parametro Verbose e la variabile RepositoryStatus

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

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

L'output mostra lo stato di analisi per ogni repository configurato per il processo di analisi del contenuto.

Esempio 5: Usare il parametro Verbose e la variabile CurrentScanSummary

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


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

L'output mostra ulteriori dettagli sull'analisi attualmente in esecuzione, incluso il numero di file analizzati, classificati ed etichettati e il numero di byte analizzati.

Input

None

Output

System.Object