Поделиться через

Get-ScanStatus

  • Ссылка
Модуль:
PurviewInformationProtection

Возвращает текущее состояние службы для сканера Защита информации Microsoft Purview.

Синтаксис

Get-ScanStatus []

Описание

Командлет Get-ScanStatus возвращает следующие сведения о текущем состоянии кластера сканера:

  • Имя кластера

  • Состояние кластера, в том числе:

    • В автономном режиме: служба не запущена
    • Бездействует: служба запущена, но в настоящее время не выполняется сканирование.
    • Сканирование: служба запущена и в настоящее время сканирует файлы.
    • Ошибка. Служба проверки запущена, но возникла ошибка, которая не позволяет проверять файлы. Например, служба не может получить доступ к базе данных для конфигурации сканера.

  • Время начала сканирования: время последнего запуска сканирования в формате UTC.

  • Время от начала: длительность сканирования в следующем формате: Days.HH:MM:SS

  • Сведения об узле: список узлов в кластере сканера.

Чтобы получить дополнительные сведения, используйте один или оба следующих метода:

  • Используйте переменную NodesInfo для просмотра сведений о текущем состоянии сканирования для каждого узла. Дополнительные сведения см. в примерах.

  • Используйте параметр Verbose для просмотра таких сведений, как количество отсканированных файлов, объем сканируемых данных и сведения о каждом сканированном репозитории.

    При использовании параметра Verbose детализируйте дополнительные сведения о репозиториях с помощью переменных RepositoriesStatus или CurrentScanSummary .

    Возможные состояния репозитория:

    • Пропущено, если репозиторий был пропущен
    • Ожидание, если текущая проверка не запущена, проверка репозитория
    • Проверка, если текущая проверка выполняется в репозитории
    • Завершено, если текущая проверка завершена в репозитории

Дополнительные сведения см. в статье Проверка сведений о сканировании для каждого узла и репозитория сканера.

Примеры

Пример 1. Получение текущего состояния службы проверки

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}

Эти выходные данные показывают, что проверка в настоящее время выполняется в contoso-test кластере и была запущена 37 секунд назад, 10 марта 2021 г. в 9:05:02.

Выходные данные также показывают, что кластер contoso-test имеет три узла.

Пример 2. Использование параметра Verbose для получения данных для текущего сканирования

PS C:\> Get-ScanStatus -Verbose

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

В выходных данных показан только один репозиторий. В случае с несколькими репозиториями каждый из них указывается отдельно.

Пример 3. Использование переменной NodesInfo для получения сведений о состоянии сканирования на каждом узле

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

Эти выходные данные сначала отображают сведения о текущем состоянии сканирования и список узлов в кластере, а затем сведения о каждом узле в таблице.

При дальнейшей детализации с использованием целого числа узла отображается длинный список сведений о сканировании на выбранном узле, например количество отсканированных, классифицированных и помеченных файлов, а также количество отсканированных байтов.

При использовании переменной NodesInfo для детализации сведений об узле целые числа узлов начинаются с 0.

Пример 4. Использование параметра Verbose и переменной RepositoriesStatus

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

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

В выходных данных отображается состояние проверки для каждого репозитория, настроенного для задания сканирования содержимого.

Пример 5. Использование параметра Verbose и переменной CurrentScanSummary

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


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

В выходных данных отображаются дополнительные сведения о текущем сканировании, включая количество проверенных, неудачных, классифицированных и помеченных файлов, а также количество сканированных байтов.

Входные данные

None

Выходные данные

System.Object