Get-AIPScannerStatus

  • Referencia
Módulo:
AzureInformationProtection

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

Syntax

Get-AIPScannerStatus []

Description

Este cmdlet es compatible con los clientes de etiquetado clásico y unificado de Azure Information Protection, con un uso diferente, como se describe a continuación.

Cliente de etiquetado unificado

El cmdlet Get-AIPScannerStatus devuelve los detalles siguientes 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 ha encontrado 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, consulta los ejemplos que se indican a continuación.

  • 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 aún no ha empezado a examinar el repositorio.
    • Examen, si el examen actual se está ejecutando en el repositorio
    • Finalizado, si el examen actual se ha completado en ejecución 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: Obtener el estado actual del servicio de escáner (cliente de etiquetado unificado)

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}

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

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

Ejemplo 2: Usar el parámetro Verbose para obtener datos para el examen actual (cliente de etiquetado unificado)

PS C:\> Get-AIPScannerStatus -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 se mostrará por separado.

Ejemplo 3: Usar la variable NodesInfo para obtener detalles sobre el estado de examen en cada nodo (cliente de etiquetado unificado)

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

En primer lugar, esta salida muestra detalles sobre el estado del examen actual, así como una lista de nodos del clúster y, a continuación, 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, así como 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 (cliente de etiquetado unificado)

PS C:\Windows\system32> $x=Get-AIPScannerStatus -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, así como el número de bytes examinados.

Entradas

None

Salidas

System.Object