Set-ScannerContentScan

  • Referencia
Módulo:
PurviewInformationProtection

Define la configuración de un trabajo de examen de contenido de Microsoft Purview Information Protection analizador.

Sintaxis

Set-ScannerContentScan
   [-Schedule <Schedule>]
   [-DiscoverInformationTypes <DiscoverInformationTypes>]
   [-RecommendedAsAutomatic <OnOffEnum>]
   [-EnableDlp <OnOffEnum>]
   [-Enforce <OnOffEnum>]
   [-LabelFilesByContent <OnOffEnum>]
   [-RelabelFiles <OnOffEnum>]
   [-AllowLabelDowngrade <OnOffEnum>]
   [-EnforceDefaultLabel <OnOffEnum>]
   [-DefaultLabelType <DefaultLabelType>]
   [-DefaultLabelId <Guid>]
   [-DefaultOwner <String>]
   [-RepositoryOwner <String>]
   [-PreserveFileDetails <OnOffEnum>]
   [-IncludeFileTypes <String>]
   [-ExcludeFileTypes <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Define la configuración del trabajo de examen de contenido, que examina el contenido de los repositorios definidos, según la configuración definida. Para obtener más información sobre los trabajos de examen de contenido, consulte la documentación del analizador local de Microsoft Purview Information Protection.

Ejemplos

Ejemplo 1 Definir la configuración predeterminada del trabajo de examen de contenido

PS C:\WINDOWS\system32> Set-ScannerContentScan -Enforce Off

En este ejemplo se define el trabajo de examen de contenido con la configuración predeterminada y se establece la opción Cumplimiento de directivas en Desactivado.

Ejemplo 2: Definición de un trabajo de examen de contenido básico que se ejecuta continuamente

PS C:\WINDOWS\system32> Set-ScannerContentScan -Enforce Off -RelabelFiles On -EnforceDefaultLabel On -Schedule Always

En este ejemplo se define el trabajo de examen de contenido con sin aplicar una directiva, lo que permite que los archivos se vuelvan a etiquetar, mediante una etiqueta predeterminada y se programa para ejecutarse siempre.

Ejemplo 3 Definir un trabajo de examen de contenido que permita solo acciones de reetitiqueción específicas

PS C:\WINDOWS\system32> Set-ScannerContentScan -RelabelFiles On -AllowLabelDowngrade On -EnforceDefaultLabel On

En este ejemplo se define un trabajo de examen de contenido que permite que el contenido se vuelva a etiquetar solo para degradar una etiqueta o usar una etiqueta predeterminada.

Ejemplo 4: Definición de un trabajo de examen de contenido que excluye .msg y archivos de .tmp

PS C:\WINDOWS\system32> Set-ScannerContentScan -IncludeFileTypes '' -ExcludeFileTypes '.msg,.tmp'

En este ejemplo se define un trabajo de examen de contenido que incluye todos los tipos de archivo, excepto los archivos de .msg y .tmp.

Ejemplo 5: Definición de un trabajo de examen de contenido con DLP habilitado y un propietario de repositorio específico

PS C:\WINDOWS\system32> Set-ScannerContentScan -EnableDLP On -RepositoryOwner 'domain\user'

En este ejemplo se define el trabajo de examen de contenido para usar los tipos de información de confidencialidad de prevención de pérdida de datos (DLP) de Microsoft Purview al examinar el contenido y también se define un propietario específico para los repositorios del trabajo de análisis de contenido.

Ejemplo 6 Definir un trabajo de examen de contenido con una etiqueta predeterminada que se va a usar al etiquetar automáticamente el contenido

PS C:\WINDOWS\system32> Set-ScannerContentScan -DefaultLabelType Custom -DefaultLabelId 'ff1f1c9d-2f92-4a18-3d84-4608b742424'

En este ejemplo se define el trabajo de examen de contenido con una etiqueta específica usada como etiqueta predeterminada, especificada por el identificador de etiqueta.

Parámetros

-AllowLabelDowngrade

Determina si el trabajo de examen de contenido permite etiquetar acciones de degradación.

Solo es relevante cuando el parámetro RelabelFiles está establecido en activado.

Tipo:OnOffEnum
Valores aceptados:On, Off
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultLabelId

Define el identificador de la etiqueta predeterminada que se usa al etiquetar automáticamente el contenido con una etiqueta predeterminada.

Obligatorio si el parámetro DefaultLabelType está establecido en personalizado.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultLabelType

Determina el tipo de etiqueta predeterminada usada al etiquetar automáticamente el contenido con una etiqueta predeterminada.

Cuando se usa, defina el identificador de etiqueta que desea usar como identificador predeterminado mediante el parámetro DefaultLabelId .

Tipo:DefaultLabelType
Valores aceptados:None, PolicyDefault, Custom
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultOwner

Define el valor de propietario predeterminado usado para los archivos examinados, mediante la dirección de correo electrónico de la cuenta. De forma predeterminada, se trata de la cuenta del analizador.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DiscoverInformationTypes

Determina los tipos de tipos de información detectados durante el trabajo de examen de contenido.

Tipo:DiscoverInformationTypes
Valores aceptados:PolicyOnly, All
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableDlp

Determina si el trabajo de examen de contenido usa los tipos de información de confidencialidad de prevención de pérdida de datos (DLP) al examinar el contenido.

Sugerencia

Si configura este parámetro, también puede configurar un propietario de repositorio específico mediante el parámetro RepositoryOwner .

Tipo:OnOffEnum
Valores aceptados:On, Off
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Enforce

Determina si el trabajo de examen de contenido aplica el examen de contenido y el etiquetado según la directiva.

Tipo:OnOffEnum
Valores aceptados:On, Off
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnforceDefaultLabel

Determina si el uso de una etiqueta predeterminada siempre se usa al volver a etiquetar el contenido.

Solo es relevante cuando el parámetro RelabelFiles está establecido en activado.

Tipo:OnOffEnum
Valores aceptados:On, Off
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExcludeFileTypes

Determina los tipos de archivo que se omiten durante el trabajo de examen de contenido. Defina varios tipos de archivo mediante una lista separada por comas.

Si define este parámetro, defina el parámetro IncludeFileTypes como null. Por ejemplo, ejemplo 4 anterior.

Solo es relevante cuando el parámetro OverrideContentScanJob está establecido en activado en los cmdlets Add-ScannerRepository o Set-ScannerRepository .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IncludeFileTypes

Determina explícitamente los tipos de archivo examinados por el trabajo de examen de contenido. Defina varios tipos de archivo mediante una lista separada por comas.

Si define este parámetro, defina el parámetro ExcludeFileTypes como null. Por ejemplo, ejemplo 4 anterior.

Solo es relevante cuando el parámetro OverrideContentScanJob está establecido en activado en los cmdlets Add-ScannerRepository o Set-ScannerRepository .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LabelFilesByContent

Determina si la opción de trabajo De examen de contenido basado en archivos de etiqueta está habilitada o deshabilitada.

Tipo:OnOffEnum
Valores aceptados:On, Off
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PreserveFileDetails

Determina si los detalles del archivo, incluida la fecha modificada, la última modificación y la modificación por configuración, se conservan durante el examen y el etiquetado automático.

Tipo:OnOffEnum
Valores aceptados:On, Off
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RecommendedAsAutomatic

Determina si las etiquetas recomendadas se usan para etiquetar automáticamente el contenido.

Tipo:OnOffEnum
Valores aceptados:On, Off
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RelabelFiles

Determina si el trabajo de examen de contenido puede volver a etiquetar los archivos.

Sugerencia

Al usar este parámetro, use los siguientes parámetros adicionales según sea necesario:

  • EnforceDefaultLabel
  • AllowLabelDowngrade
Tipo:OnOffEnum
Valores aceptados:On, Off
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RepositoryOwner

Especifica el SAMAccountname (domain\user), UPN (user@domain) o SID de un grupo que posee el repositorio.

A los propietarios se les conceden permisos de control total en el archivo si los permisos del archivo cambian mediante una regla DLP coincidente.

Solo es relevante cuando el parámetro EnableDlp está establecido en activado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Schedule

Determina si el trabajo de examen de contenido se ejecuta según una programación específica o continuamente.

Tipo:Schedule
Valores aceptados:Manual, Always
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

System.Object