Set-ScannerConfiguration
Задает необязательную конфигурацию для сканера защиты информации Microsoft Purview.
Синтаксис
Default (По умолчанию)
Set-ScannerConfiguration
[-ReportLevel <ReportLevel>]
[-OnlineConfiguration <OnlineConfiguration>]
[-FeatureSettings <Hashtable>]
Описание
Командлет Set-ScannerConfiguration задает параметры локальной конфигурации для сканера защиты информации Microsoft Purview.
Большинство параметров конфигурации сканера настраивается на портале соответствия требованиям Microsoft Purview, но этот командлет необходимо использовать, если необходимо импортировать параметры конфигурации из файла, так как сканер не поддерживает оперативную конфигурацию, или если необходимо изменить уровень отчета для локально созданных отчетов.
Любые изменения будут использованы при следующем запуске сканера. Если необходимо, чтобы изменения вступили в силу немедленно, перезапустите сканер защиты информации Microsoft Purview на серверном компьютере Windows.
Примеры
Пример 1: Настройте сканер защиты информации Microsoft Purview для использования онлайн-конфигурации
PS C:\> Set-ScannerConfiguration -OnlineConfiguration On
Configuration was set successfully.
Эта команда настраивает сканер на получение конфигурации непосредственно из службы защиты информации Microsoft Purview.
Пример 2: Включить функцию сканирования на уровне кластера (предпросмотр)
PS C:\> Set-ScannerConfiguration -FeatureSettings @{CustomReporting=$true}
Configuration was set successfully.
Эта команда активирует функцию пользовательской отчетности для всего кластера сканеров. Все узлы фиксируют изменение в следующем цикле сканирования. Перезапуск службы не требуется.
Вы можете передавать несколько признаков в одной хэш-таблице. Cmdlet проверяет каждое имя и значение до того, как что-либо записывает; Если какая-либо запись недействительна, вызов прерывается, и настройки не применяются.
Если функция управляется через Портал Microsoft Purview, cmdlet пропускает её с предупреждением и оставляет состояние кластера без изменений. Другие функции в том же вызове всё ещё применяются.
Для информации и списка функций, поддерживаемых этой клиентской версией, см. Управление функциями сканера (предварительный просмотр).
Параметры
-FeatureSettings
(Публичный предварительный просмотр) Настройка функций сканера Защита информации Microsoft Purview на уровне кластера. Эта настройка применяется ко всем узлам кластера в следующем цикле сканирования. Перезапуск службы не требуется.
-FeatureSettings принимает хэш-таблицу PowerShell с именем признаков и парами настраиваний. Каждая клавиша — это имя функции (например, CustomReporting); поддерживаемые значения каждой функции документируются в режиме управления функциями Scanner (предварительный просмотр).
Например: Set-ScannerConfiguration -FeatureSettings @{CustomReporting=$true}.
И имя, и значение функции проверяются до записи любых изменений. Если какая-либо запись недействительна, cmdlet заканчивается, и записи из хеш-таблицы не применяются.
Если функция настроена из Портал Microsoft Purview, cmdlet издаёт предупреждение и оставляет строку этой функции неизменной. Другие функции в той же хэш-таблице, которые не управляются порталом, всё равно применяются.
Для предыстории, поддерживаемых функций и примеров см. Управление функциями сканера (предварительный просмотр).
Если функция настроена из Портал Microsoft Purview, cmdlet издаёт предупреждение и оставляет строку этой функции неизменной. Другие функции в той же хэш-таблице, которые не управляются порталом, всё равно применяются.
Для справки: список функций, поддерживаемых этой клиентской версией, и примеры см. в разделе Scanner feature control (preview).
Свойства параметров
| Тип: | Hashtable |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OnlineConfiguration
Указывает, получает ли сканер параметры конфигурации непосредственно из службы защиты информации Microsoft Purview (по умолчанию) или использует автономный файл конфигурации.
На: Настройка по умолчанию. Параметры конфигурации сканер получает непосредственно из службы защиты информации Microsoft Purview.
От: Сканер не может получить параметры конфигурации непосредственно из службы защиты информации Microsoft Purview. Вместо этого сканер настраивается с помощью параметров, импортируемых из файла.
Если сканер не поддерживает оперативную конфигурацию, необходимо настроить сканер на портале Azure. Затем экспортируйте конфигурацию сканера с портала в файл .json и импортируйте этот файл с помощью командлета Import-ScannerConfiguration .
Свойства параметров
| Тип: | OnlineConfiguration |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ReportLevel
Определение уровня ведения журнала для отчетов сканера. По умолчанию в файл журнала включаются только те файлы, которые были успешно помечены сканером или содержат типы конфиденциальной информации.
Файлы журналов хранятся в папке%localappdata%\Microsoft\MSIP\Scanner\Reports . Сводный отчет (.txt) включает время, затраченное на сканирование, количество проверенных файлов и статистику о том, сколько файлов было классифицировано и защищено. Подробные отчеты (.csv) содержат детали по каждому файлу. В папке хранится до 60 отчетов для каждого цикла сканирования, и все отчеты, кроме последнего, сжимаются, чтобы свести к минимуму необходимое дисковое пространство.
| Уровень логирования | Описание |
|---|---|
| Debug | Регистрирует каждый обнаруженный файл и результирующее действие. Этот уровень ведения журнала полезен для устранения неполадок, но замедляет работу сканера защиты информации Microsoft Purview. В эту категорию входят файлы, которые не соответствуют ни одному из условий, и файлы, которые пропускаются из-за неподдерживаемого типа файлов.
Например, попытка пометить файл только для классификации, если тип файла не поддерживает это действие, и попытка пометить файлы, которые автоматически исключаются. |
| Информация (по умолчанию) | Регистрирует только те файлы, которые: - Были успешно маркированы сканером - Был бы помечен сканером, если бы сканер не находился в режиме обнаружения - Содержат конфиденциальные типы информации |
| Ошибка | Регистрирует только те файлы, которые сканер пытался пометить или идентифицировать, но не смог. Например, файл использовался, или у службы сканера не было доступа на запись к файлу. |
| Выкл. | Отключает отчеты, что обеспечивает наилучшую производительность сканера. |
Локальный журнал событий приложений и служб Windows, сканер защиты информации содержит дополнительные сведения о журнале. События включают время начала и окончания каждого цикла сканирования, когда к отсканированному файлу применена метка, а также когда применяется или снимается защита.
Свойства параметров
| Тип: | ReportLevel |
| Default value: | None |
| Допустимые значения: | Off, Debug, Info, Error |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |