Get-AIPScannerStatus

  • Referência
Módulo:
AzureInformationProtection

Obtém o estado do serviço atual para o analisador de Information Protection do Azure.

Syntax

Get-AIPScannerStatus []

Description

Este cmdlet é suportado pelo Azure Information Protection clientes de etiquetagem clássica e unificada, com utilização diferente, conforme descrito abaixo.

Cliente de etiquetagem unificada

O cmdlet Get-AIPScannerStatus devolve os seguintes detalhes sobre o estado do cluster do scanner atual:

  • Nome do cluster

  • Estado do cluster, incluindo:

    • Offline: o serviço não foi iniciado
    • Inativo: o serviço está em execução, mas não está atualmente a analisar
    • Análise: o serviço está em execução e está atualmente a analisar ficheiros
    • Error. O serviço de scanner está em execução, mas encontrou um erro que o impede de analisar ficheiros. Por exemplo, o serviço não consegue aceder à base de dados para a configuração do scanner.

  • Hora de início da análise: a hora em que a última análise foi iniciada, no formato de hora UTC.

  • Hora do início: a duração da análise, no seguinte formato: Days.HH:MM:SS

  • Informações do nó: uma lista dos nós no cluster do scanner

Para obter mais detalhes, utilize um ou ambos os seguintes métodos:

  • Utilize a variável NodesInfo para ver detalhes sobre o estado de análise atual de cada nó. Para obter mais informações, veja os exemplos abaixo.

  • Utilize o parâmetro Verboso para ver detalhes, como o número de ficheiros analisados, a quantidade de dados analisados e os detalhes de cada repositório analisado.

    Ao utilizar o parâmetro Verboso , desagregue mais para obter mais detalhes sobre os repositórios com as variáveis RepositóriosStatus ou CurrentScanSummary .

    Os estados possíveis do repositório incluem:

    • Ignorado, se o repositório tiver sido ignorado
    • Pendente, se a análise atual ainda não tiver começado a analisar o repositório
    • A analisar, se a análise atual estiver em execução no repositório
    • Concluído, se a análise atual tiver sido concluída em execução no repositório

Para obter mais informações, veja Verificar os detalhes de análise por nó de scanner e repositório.

Exemplos

Exemplo 1: obter o estado atual do serviço de scanner (cliente de etiquetagem unificada)

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}

Este resultado mostra que uma análise está atualmente em execução contoso-test no cluster e foi iniciada há 37 segundos, a 10/03/2021 9:05:02.

O resultado também mostra que o contoso-test cluster tem 3 nós.

Exemplo 2: utilizar o parâmetro Verboso para obter dados para a análise atual (cliente de etiquetagem unificada)

PS C:\> Get-AIPScannerStatus -Verbose

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

Este resultado mostra apenas um único repositório. Em casos de múltiplos repositórios, cada um deles será listado separadamente.

Exemplo 3: utilize a variável NodesInfo para obter detalhes sobre o estado de análise em cada nó (cliente de etiquetagem unificada)

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

Este resultado apresenta primeiro detalhes sobre o estado da análise atual, bem como uma lista de nós no cluster e, em seguida, detalhes para cada nó, numa tabela.

A desagregação adicional com o número inteiro do nó mostra uma longa lista de detalhes sobre a análise no nó selecionado, como o número de ficheiros digitalizados, classificados e etiquetados, bem como o número de bytes analisados.

Ao utilizar a variável NodesInfo para desagregar para detalhes do nó, os números inteiros de nós começam com 0.

Exemplo 4: utilizar o parâmetro Verboso e a variável RepositoriesStatus (cliente de etiquetagem unificada)

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

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

O resultado mostra o estado de análise de cada repositório configurado para a tarefa de análise de conteúdos.

Exemplo 5: Utilizar o parâmetro Verboso e a variável CurrentScanSummary

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


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

O resultado mostra mais detalhes sobre a análise atualmente em execução, incluindo o número de ficheiros analisados, falhados, classificados e etiquetados, bem como o número de bytes analisados.

Entradas

None

Saídas

System.Object