Get-ScanStatus

  • Référence
Module:
PurviewInformationProtection

Obtient la status actuelle du service pour le scanneur Protection des données Microsoft Purview.

Syntaxe

Get-ScanStatus []

Description

L’applet de commande Get-ScanStatus retourne les détails suivants sur le cluster d’analyseur actuel status :

  • Nom du cluster

  • Status de cluster, notamment :

    • Hors connexion : le service n’est pas démarré
    • Inactif : le service est en cours d’exécution mais n’est pas analysé actuellement
    • Analyse : le service est en cours d’exécution et analyse actuellement les fichiers
    • Erreur. Le service de scanneur est en cours d’exécution, mais il a rencontré une erreur qui l’empêche d’analyser les fichiers. Par exemple, le service ne peut pas accéder à la base de données pour la configuration du scanneur.

  • Heure de début de l’analyse : heure à laquelle la dernière analyse a démarré, au format d’heure UTC.

  • Durée du début : Durée de l’analyse, au format suivant : Days.HH:MM:SS

  • Informations sur les nœuds : liste des nœuds dans le cluster d’analyseur

Pour obtenir plus de détails, utilisez l’une des méthodes suivantes ou les deux :

  • Utilisez la variable NodesInfo pour afficher des détails sur la status d’analyse actuelle pour chaque nœud. Pour plus d'informations, consultez les exemples.

  • Utilisez le paramètre Détaillé pour afficher des détails tels que le nombre de fichiers analysés, la quantité de données analysées et les détails de chaque dépôt analysé.

    Lorsque vous utilisez le paramètre Verbose , explorez plus en détail les dépôts à l’aide des variables RepositoriesStatus ou CurrentScanSummary .

    Les états de dépôt possibles sont les suivants :

    • Ignoré, si le dépôt a été ignoré
    • En attente, si l’analyse actuelle n’a pas démarré l’analyse du dépôt
    • Analyse, si l’analyse actuelle s’exécute sur le dépôt
    • Terminé, si l’analyse en cours a fini de s’exécuter sur le dépôt

Pour plus d’informations, consultez Vérifier les détails de l’analyse par nœud et dépôt du scanneur.

Exemples

Exemple 1 : Obtenir la status actuelle du service scanneur

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}

Cette sortie indique qu’une analyse est actuellement en cours d’exécution sur le contoso-test cluster et qu’elle a été démarrée il y a 37 secondes, le 10 mars 2021 à 09 :05 :02.

La sortie indique également que le contoso-test cluster a trois nœuds.

Exemple 2 : Utiliser le paramètre Verbose pour obtenir des données pour l’analyse actuelle

PS C:\> Get-ScanStatus -Verbose

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

Cette sortie n’affiche qu’un seul dépôt. Dans le cas de plusieurs dépôts, chacun d’eux est répertorié séparément.

Exemple 3 : Utiliser la variable NodesInfo pour obtenir des détails sur les status d’analyse sur chaque nœud

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

Cette sortie affiche d’abord les détails de l’analyse actuelle status et une liste de nœuds dans le cluster, puis les détails de chaque nœud, dans une table.

L’exploration ultérieure à l’aide de l’entier du nœud affiche une longue liste de détails sur l’analyse sur le nœud sélectionné, comme le nombre de fichiers analysés, classifiés et étiquetés, ainsi que le nombre d’octets analysés.

Lorsque vous utilisez la variable NodesInfo pour accéder aux détails du nœud, les entiers de nœud commencent par 0.

Exemple 4 : Utiliser le paramètre Verbose et la variable RepositoriesStatus

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

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

La sortie montre la status d’analyse pour chaque dépôt configuré pour le travail d’analyse de contenu.

Exemple 5 : Utiliser le paramètre Verbose et la variable CurrentScanSummary

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


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

La sortie affiche des détails supplémentaires sur l’analyse en cours d’exécution, notamment le nombre de fichiers analysés, ayant échoué, classés et étiquetés, ainsi que le nombre d’octets analysés.

Entrées

None

Sorties

System.Object