Partager via

Get-AIPScannerStatus

  • Référence
Module:
AzureInformationProtection

Obtient la status de service actuelle pour l’analyseur Azure Information Protection.

Syntaxe

Get-AIPScannerStatus []

Description

Cette applet de commande est prise en charge par les clients Azure Information Protection d’étiquetage classique et unifié, avec une utilisation différente, comme décrit ci-dessous.

Client d’étiquetage unifié

L’applet de commande Get-AIPScannerStatus 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 d’analyse 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 ci-dessous.

  • 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 en cours n’a pas encore commencé à analyser le dépôt
    • Analyse, si l’analyse actuelle s’exécute sur le dépôt
    • Terminé, si l’analyse en cours s’est terminée 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 (client d’étiquetage unifié)

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}

Cette sortie montre 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, à 03/10/2021 09 :05 :02.

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

Exemple 2 : Utiliser le paramètre Verbose pour obtenir des données pour l’analyse actuelle (client d’étiquetage unifié)

PS C:\> Get-AIPScannerStatus -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 (client d’étiquetage unifié)

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

Cette sortie affiche tout d’abord les détails de l’analyse actuelle status ainsi qu’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 (client d’étiquetage unifié)

PS C:\Windows\system32> $x=Get-AIPScannerStatus -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