Get-AIPScannerStatus
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