Get-AIPScannerStatus

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

Возвращает текущее состояние службы для средства проверки Information Protection Azure.

Синтаксис

Get-AIPScannerStatus []

Описание

Этот командлет поддерживается клиентами azure Information Protection классических и унифицированных меток с различным использованием, как описано ниже.

Клиент унифицированных меток

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примеры

Пример 1. Получение текущего состояния службы проверки (клиент унифицированных меток)

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}

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

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

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

PS C:\> Get-AIPScannerStatus -Verbose

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

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

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

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

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

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

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

Пример 4. Использование параметра Verbose и переменной RepositoriesStatus (клиент унифицированных меток)

PS C:\Windows\system32> $x=Get-AIPScannerStatus -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