Set-ScannerConfiguration
Establece la configuración opcional para el escáner de Microsoft Purview Information Protection.
Sintaxis
Default (valor predeterminado)
Set-ScannerConfiguration
[-ReportLevel <ReportLevel>]
[-OnlineConfiguration <OnlineConfiguration>]
[-FeatureSettings <Hashtable>]
Description
El cmdlet Set-ScannerConfiguration establece las opciones de configuración local para el escáner de Microsoft Purview Information Protection.
La mayoría de las opciones de configuración del escáner se configuran en el portal de cumplimiento Microsoft Purview, pero deben usar este cmdlet si necesitan importar las opciones de configuración de un archivo porque el escáner no admite la configuración en línea, o si necesitan cambiar el nivel de informe de los informes creados localmente.
Los cambios se utilizarán la próxima vez que se ejecute el escáner. Si necesita que los cambios surtan efecto inmediatamente, reinicie el escáner de Microsoft Purview Information Protection en el equipo servidor Windows.
Ejemplos
Ejemplo 1: Establecer el escáner de Microsoft Purview Information Protection para usar la configuración en línea
PS C:\> Set-ScannerConfiguration -OnlineConfiguration On
Configuration was set successfully.
Este comando establece el escáner para obtener su configuración directamente del servicio Microsoft Purview Information Protection.
Ejemplo 2: Habilitar una función de escáner a nivel de clúster (vista previa)
PS C:\> Set-ScannerConfiguration -FeatureSettings @{CustomReporting=$true}
Configuration was set successfully.
Este comando activa la función de Informes Personalizados para todo el clúster de escáneres. Todos los nodos detectan el cambio en su siguiente ciclo de escaneo. No es necesario reiniciar el servicio.
Puedes pasar varias características en una sola tabla hash. El cmdlet valida cada nombre y valor de característica antes de escribir nada; si alguna entrada es inválida, la llamada termina y no se aplican ajustes.
Si una función se gestiona desde el Microsoft Purview portal, el cmdlet la omite con una advertencia y deja el estado del clúster sin cambios. Otras características en la misma llamada siguen aplicándose.
Para contexto y la lista de funciones soportadas por esta versión cliente, véase Control de funciones del escáner (vista previa).
Parámetros
-FeatureSettings
(Avance público) Configura las funciones del escáner Microsoft Purview Information Protection a nivel de clúster. La configuración se aplica a todos los nodos del clúster en el siguiente ciclo de escaneo. No es necesario reiniciar el servicio.
-FeatureSettings acepta una tabla hash de PowerShell con pares de nombres de características y configuraciones. Cada clave es el nombre de la característica (por ejemplo, CustomReporting); los valores soportados para cada característica se documentan en el control de características del Escáner (vista previa).
Por ejemplo: Set-ScannerConfiguration -FeatureSettings @{CustomReporting=$true}.
Tanto el nombre como el valor de la característica se validan antes de que se escriba cualquier cambio. Si alguna entrada es inválida, el cmdlet termina y no se aplican entradas de la tabla hash.
Si una función ha sido configurada desde el Microsoft Purview portal, el cmdlet emite una advertencia y deja la fila de esa característica sin cambios. Otras funciones en la misma tabla hash que no están gestionadas por portales siguen aplicándose.
Para información en fondo, características compatibles y ejemplos, véase Control de funciones del escáner (vista previa).
Si una función ha sido configurada desde el Microsoft Purview portal, el cmdlet emite una advertencia y deja la fila de esa característica sin cambios. Otras funciones en la misma tabla hash que no están gestionadas por portales siguen aplicándose.
Para contexto, la lista de funciones soportadas por esta versión cliente y ejemplos, véase Control de funciones del escáner (vista previa).
Propiedades de parámetro
| Tipo: | Hashtable |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-OnlineConfiguration
Especifica si el escáner obtiene sus opciones de configuración directamente del servicio Microsoft Purview Information Protection (el valor predeterminado) o usa un archivo de configuración sin conexión.
En: La configuración predeterminada. El escáner obtiene sus opciones de configuración directamente del servicio Microsoft Purview Information Protection.
Apagado: Se impide que el escáner obtenga sus opciones de configuración directamente del servicio Microsoft Purview Information Protection. En su lugar, el escáner se configura mediante la configuración que se importa de un archivo.
Si el escáner no admite la configuración en línea, debe configurarlo en Azure Portal. A continuación, exporte la configuración del escáner del portal a un archivo de .json e importe este archivo mediante el cmdlet Import-ScannerConfiguration .
Propiedades de parámetro
| Tipo: | OnlineConfiguration |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ReportLevel
Defina el nivel de registro para los informes del escáner. De forma predeterminada, solo se incluyen en el archivo de registro los archivos etiquetados correctamente por el analizador o que contienen tipos de información confidencial.
Los archivos de registro se almacenan en la carpeta %localappdata%\Microsoft\MSIP\Scanner\Reports . Un informe de resumen (.txt) incluye el tiempo que se tarda en analizar, el número de archivos analizados y estadísticas de cuántos archivos se clasificaron y protegieron. Informes detallados (.csv) tiene detalles para cada archivo. La carpeta almacena hasta 60 informes para cada ciclo de análisis y todos los informes, excepto el más reciente, se comprimen para ayudar a minimizar el espacio en disco necesario.
| Nivel de registro | Descripción |
|---|---|
| Depurar | Registra todos los archivos que se detectaron y la acción resultante. Este nivel de registro es útil para solucionar problemas, pero ralentiza el escáner de Microsoft Purview Information Protection. Esta categoría incluye los archivos que no cumplen ninguna de las condiciones y los archivos que se omiten debido a un tipo de archivo no compatible.
Por ejemplo, intentar etiquetar un archivo solo para clasificación cuando el tipo de archivo no admite esta acción e intentar etiquetar archivos que se excluyen automáticamente. |
| info (predeterminado) | Registra solo los archivos que: - Fueron etiquetados con éxito por el escáner - Habría sido etiquetado por el escáner, si el escáner no estaba en modo de detección - Contener tipos de información confidencial |
| Error | Registra solo los archivos que el escáner intentó etiquetar o identificar, pero no pudo. Por ejemplo, un archivo estaba en uso o el servicio de análisis no tenía acceso de escritura al archivo. |
| Desactivado | Deshabilita los informes, lo que da como resultado el mejor rendimiento para el escáner. |
El registro de eventos de aplicaciones y servicios de Windows local, Information Protection Scanner , contiene información de registro adicional. Los eventos incluyen las horas de inicio y finalización de cada ciclo de análisis, cuándo se aplica una etiqueta a un archivo analizado y cuándo se aplica o se quita la protección.
Propiedades de parámetro
| Tipo: | ReportLevel |
| Valor predeterminado: | None |
| Valores aceptados: | Off, Debug, Info, Error |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |