Compartilhar via


Get-ScanStatus

Obtém o status atual do serviço para o scanner de Proteção de Informações do Microsoft Purview.

Sintaxe

Get-ScanStatus []

Description

O cmdlet Get-ScanStatus retorna os seguintes detalhes sobre o cluster de 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 a verificação atual status para cada nó. Para obter mais informações, consulte os exemplos.

  • 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 não for iniciada, verifique o repositório
    • Verificação, se a verificação atual estiver em execução no repositório
    • Concluído, se a verificação atual terminar de ser executada 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

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}

Essa saída mostra que uma verificação está em execução contoso-test no cluster e foi iniciada há 37 segundos, 10 de março de 2021 às 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

PS C:\> Get-ScanStatus -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 é listado separadamente.

Exemplo 3: usar a variável NodesInfo para obter detalhes sobre a verificação status em cada nó

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

Essa saída primeiro exibe detalhes sobre a verificação atual status e 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 verificados, classificados e rotulados e 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

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

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

A saída mostra o status de verificação de 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 e o número de bytes verificados.

Entradas

None

Saídas

System.Object