Compartir a través de

Get-ScanStatus

  • Referencia
Módulo:
PurviewInformationProtection

Obtiene el estado actual del servicio para el analizador de Microsoft Purview Information Protection.

Sintaxis

Get-ScanStatus []

Description

El cmdlet Get-ScanStatus devuelve los siguientes detalles sobre el estado actual del clúster del analizador:

  • Nombre del clúster

  • Estado del clúster, incluido:

    • Sin conexión: el servicio no se inicia
    • Inactivo: el servicio se está ejecutando pero no está examinando actualmente.
    • Examen: el servicio se está ejecutando y está examinando archivos actualmente.
    • Error. El servicio del analizador se está ejecutando, pero encontró un error que impide que se examinan los archivos. Por ejemplo, el servicio no puede acceder a la base de datos para la configuración del analizador.

  • Hora de inicio del examen: la hora en que se inició el último examen, en formato de hora UTC.

  • Hora desde el inicio: la duración del examen, en el siguiente formato: Days.HH:MM:SS

  • Información del nodo: una lista de los nodos del clúster del analizador

Para obtener más detalles, use uno o ambos de los métodos siguientes:

  • Use la variable NodesInfo para ver detalles sobre el estado de examen actual de cada nodo. Para obtener más información, consulte los ejemplos.

  • Use el parámetro Verbose para ver detalles, como el número de archivos examinados, la cantidad de datos examinados y los detalles de cada repositorio examinado.

    Al usar el parámetro Verbose , explore en profundidad más para encontrar más detalles para los repositorios mediante las variables RepositoriesStatus o CurrentScanSummary .

    Los posibles estados del repositorio incluyen:

    • Omitido, si se omitió el repositorio
    • Pendiente, si el examen actual no se inicia al examinar el repositorio
    • Examen, si el examen actual se está ejecutando en el repositorio
    • Finalizado, si el examen actual terminó de ejecutarse en el repositorio.

Para obtener más información, consulte Comprobación de los detalles del examen por nodo y repositorio del analizador.

Ejemplos

Ejemplo 1: Obtención del estado actual del servicio del analizador

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}

Esta salida muestra que un examen se está ejecutando actualmente en el contoso-test clúster y se inició hace 37 segundos, el 10 de marzo de 2021 a las 9:05:02 a. m.

La salida también muestra que el contoso-test clúster tiene tres nodos.

Ejemplo 2: Uso del parámetro Detallado para obtener datos para el examen actual

PS C:\> Get-ScanStatus -Verbose

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

Esta salida muestra solo un único repositorio. En los casos de varios repositorios, cada uno aparece por separado.

Ejemplo 3: Uso de la variable NodesInfo para obtener detalles sobre el estado de examen en cada 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
....

En primer lugar, esta salida muestra detalles sobre el estado del examen actual y una lista de nodos del clúster y, a continuación, los detalles de cada nodo, en una tabla.

La exploración en profundidad con el entero de nodo muestra una larga lista de detalles sobre el examen en el nodo seleccionado, como el número de archivos examinados, clasificados y etiquetados, y el número de bytes examinados.

Al usar la variable NodesInfo para explorar en profundidad los detalles del nodo, los enteros de nodo comienzan por 0.

Ejemplo 4: Usar el parámetro Verbose y la variable RepositoriesStatus

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

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

La salida muestra el estado del examen de cada repositorio configurado para el trabajo de examen de contenido.

Ejemplo 5: Usar el parámetro Verbose y la variable CurrentScanSummary

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


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

La salida muestra más detalles sobre el examen que se está ejecutando actualmente, incluido el número de archivos examinados, con errores, clasificados y etiquetados, y el número de bytes examinados.

Entradas

None

Salidas

System.Object