Get-AIPScannerStatus

  • Referência
Módulo:
AzureInformationProtection

Obtém o status de serviço atual para o verificador de Proteção de Informações do Azure.

Syntax

Get-AIPScannerStatus []

Description

Esse cmdlet é compatível com o Azure Proteção de Informações clientes de rotulagem clássicos e unificados, com uso diferente, conforme descrito abaixo.

Cliente de rotulagem unificada

O cmdlet Get-AIPScannerStatus retorna os seguintes detalhes sobre o cluster do scanner atual status:

  • Nome do cluster

  • Status de cluster, incluindo:

    • Offline: o serviço não foi iniciado
    • Ocioso: o serviço está em execução, mas não está verificando no momento
    • Verificação: o serviço está em execução e está verificando arquivos no momento
    • Erro. O serviço de scanner está em execução, mas encontrou um erro que o impede de digitalizar arquivos. Por exemplo, o serviço não pode acessar o banco de dados para a configuração do scanner.

  • Hora de início da verificação: a hora em que a última verificação foi iniciada, no formato de hora UTC.

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

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

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

  • Use a variável NodesInfo para exibir detalhes sobre o status de verificação atual para cada nó. Veja os exemplos abaixo para obter mais informações.

  • Use o parâmetro Verbose para exibir detalhes como o número de arquivos verificados, a quantidade de dados verificados e os detalhes de cada repositório verificado.

    Ao usar o parâmetro Verbose , faça uma busca detalhada para encontrar mais detalhes para os repositórios usando as variáveis RepositoriesStatus ou CurrentScanSummary .

    Os possíveis status do repositório incluem:

    • Ignorado, se o repositório foi ignorado
    • Pendente, se a verificação atual ainda não tiver iniciado a verificação do repositório
    • Verificação, se a verificação atual estiver em execução no repositório
    • Concluído, se a verificação atual tiver sido concluída em execução no repositório

Para obter mais informações, consulte Verificar detalhes de verificação por nó de scanner e repositório.

Exemplos

Exemplo 1: Obter a status atual do serviço de scanner (cliente de rotulagem 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}

Essa saída mostra que uma verificação está em execução no contoso-test cluster e foi iniciada há 37 segundos, em 10/03/2021 9:05:02 AM.

A saída também mostra que o contoso-test cluster tem três nós.

Exemplo 2: usar o parâmetro Verbose para obter dados para a verificação atual (cliente de rotulagem unificada)

PS C:\> Get-AIPScannerStatus -Verbose

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

Essa saída mostra apenas um único repositório. Em casos de vários repositórios, cada um deles será listado separadamente.

Exemplo 3: usar a variável NodesInfo para obter detalhes sobre o status de verificação em cada nó (cliente de rotulagem 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
....

Essa saída primeiro exibe detalhes sobre o status de verificação atual, bem como uma lista de nós no cluster e, em seguida, detalhes para cada nó, em uma tabela.

O detalhamento adicional usando o inteiro do nó mostra uma longa lista de detalhes sobre a verificação no nó selecionado, como o número de arquivos digitalizados, classificados e rotulados, bem como o número de bytes verificados.

Ao usar a variável NodesInfo para fazer uma busca detalhada nos detalhes do nó, os inteiros do nó começam com 0.

Exemplo 4: usar o parâmetro Verbose e a variável RepositoriesStatus (cliente de rotulagem unificada)

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

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

A saída mostra o status de verificação para cada repositório configurado para o trabalho de verificação de conteúdo.

Exemplo 5: usar o parâmetro Verbose e a variável CurrentScanSummary

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


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

A saída mostra mais detalhes sobre a verificação em execução no momento, incluindo o número de arquivos verificados, com falha, classificados e rotulados, bem como o número de bytes verificados.

Entradas

None

Saídas

System.Object