Set-AIPScannerContentScanJob

Referencia

Módulo:: AzureInformationProtection

Define la configuración de un trabajo de examen de contenido de Azure Information Protection.

Syntax

Set-AIPScannerContentScanJob
   [-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 más información sobre los trabajos de examen de contenido, consulte la documentación del analizador local de Azure Information Protection.

Ejemplos

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

PS C:\WINDOWS\system32> Set-AIPScannerContentScanJob -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-AIPScannerContentScanJob -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-AIPScannerContentScanJob -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 Definir un trabajo de examen de contenido que excluya los archivos .msg y .tmp

PS C:\WINDOWS\system32> Set-AIPScannerContentScanJob -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 .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-AIPScannerContentScanJob -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 integrados de prevención de pérdida de datos (DLP) de Microsoft 365 al examinar el contenido y también se define un propietario específico para los repositorios del trabajo de examen 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-AIPScannerContentScanJob -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.

Type:	OnOffEnum
Accepted values:	On, Off
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	DefaultLabelType
Accepted values:	None, PolicyDefault, Custom
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DiscoverInformationTypes

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

Type:	DiscoverInformationTypes
Accepted values:	PolicyOnly, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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) integrados de Microsoft 365 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 .

Type:	OnOffEnum
Accepted values:	On, Off
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Enforce

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

Type:	OnOffEnum
Accepted values:	On, Off
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	OnOffEnum
Accepted values:	On, Off
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 se establece en en en los cmdlets Add-AIPScannerRepository o Set-AIPScannerRepository .

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 se establece en en en los cmdlets Add-AIPScannerRepository o Set-AIPScannerRepository .

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LabelFilesByContent

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

Type:	OnOffEnum
Accepted values:	On, Off
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	OnOffEnum
Accepted values:	On, Off
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RecommendedAsAutomatic

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

Type:	OnOffEnum
Accepted values:	On, Off
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	OnOffEnum
Accepted values:	On, Off
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Schedule

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

Type:	Schedule
Accepted values:	Manual, Always
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

None

Salidas

System.Object