Get-AIPScannerStatus

  • Riferimento
Modulo:
AzureInformationProtection

Ottiene lo stato del servizio corrente per lo scanner di Information Protection di Azure.

Sintassi

Get-AIPScannerStatus []

Descrizione

Questo cmdlet è supportato sia dai client di etichettatura classica che unificata di Azure Information Protection, con utilizzo diverso, come descritto di seguito.

Client per l'etichettatura unificata

Il cmdlet Get-AIPScannerStatus restituisce i dettagli seguenti sullo stato del cluster 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 seguenti.

  • 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 ha ancora avviato 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 (client di etichettatura unificata)

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}

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

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

Esempio 2: Usare il parametro Dettagliato per ottenere dati per l'analisi corrente (client di etichettatura unificata)

PS C:\> Get-AIPScannerStatus -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 verrà elencato separatamente.

Esempio 3: Usare la variabile NodeInfo per ottenere informazioni dettagliate sullo stato di analisi in ogni nodo (client di etichettatura unificata)

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

Questo output visualizza prima i dettagli sullo stato di analisi corrente, nonché 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, nonché 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 Dettagliato e la variabile RepositoryStatus (client di etichettatura unificata)

PS C:\Windows\system32> $x=Get-AIPScannerStatus -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, nonché il numero di byte analizzati.

Input

None

Output

System.Object