你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-ScannerContentScan

定义Microsoft Purview 信息保护扫描程序内容扫描作业的设置。

语法

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

说明

定义内容扫描作业的配置,该作业根据定义的设置扫描定义的存储库中的内容。 有关内容扫描作业的详细信息,请参阅Microsoft Purview 信息保护本地扫描程序文档

示例

示例 1 定义默认内容扫描作业设置

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

此示例使用默认设置定义内容扫描作业,并将 “策略强制” 选项设置为 “关闭”。

示例 2 定义连续运行的基本内容扫描作业

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

此示例定义内容扫描作业,而不强制实施策略,允许使用默认标签重新标记文件,并计划始终运行。

示例 3 定义仅允许特定重新标记操作的内容扫描作业

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

此示例定义了一个内容扫描作业,该作业允许仅重新标记内容以降级标签或使用默认标签。

示例 4 定义排除.msg和.tmp文件的内容扫描作业

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

此示例定义一个内容扫描作业,该作业包括除.msg和.tmp文件之外的所有文件类型。

示例 5 定义启用了 DLP 的内容扫描作业和特定的存储库所有者

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

此示例将内容扫描作业定义为在扫描内容时使用 Microsoft Purview 数据丢失防护 (DLP) 敏感度信息类型,还定义了内容扫描作业存储库的特定所有者。

示例 6 定义在自动标记内容时要使用的默认标签的内容扫描作业

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

此示例使用用作默认标签(由标签 ID 指定)的特定标签定义内容扫描作业。

参数

-AllowLabelDowngrade

确定内容扫描作业是否允许标记降级操作。

仅当 RelabelFiles 参数设置为 on 时才相关。

类型:OnOffEnum
接受的值:On, Off
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultLabelId

定义使用默认标签自动标记内容时使用的默认标签的 ID。

如果 DefaultLabelType 参数设置为 custom,则是必需的。

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultLabelType

确定使用默认标签自动标记内容时使用的默认标签的类型。

使用时,使用 DefaultLabelId 参数定义要用作默认 ID 的标签 ID。

类型:DefaultLabelType
接受的值:None, PolicyDefault, Custom
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultOwner

使用帐户电子邮件地址定义用于扫描的文件的默认所有者值。 默认情况下,这是扫描程序帐户。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DiscoverInformationTypes

确定在内容扫描作业期间发现的信息类型。

类型:DiscoverInformationTypes
接受的值:PolicyOnly, All
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnableDlp

确定内容扫描作业在扫描内容时是否使用数据丢失防护 (DLP) 敏感度信息类型。

提示

如果配置此参数,可能还需要使用 RepositoryOwner 参数配置特定的存储库所有者。

类型:OnOffEnum
接受的值:On, Off
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Enforce

确定内容扫描作业是否根据策略强制执行内容扫描和标记。

类型:OnOffEnum
接受的值:On, Off
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnforceDefaultLabel

确定重新标记内容时是否始终使用默认标签。

仅当 RelabelFiles 参数设置为 on 时才相关。

类型:OnOffEnum
接受的值:On, Off
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ExcludeFileTypes

确定在内容扫描作业期间忽略的任何文件类型。 使用逗号分隔的列表定义多个文件类型。

如果定义此参数,请将 IncludeFileTypes 参数定义为 null。 例如,上面的 示例 4

仅在 Add-ScannerRepository 或 Set-ScannerRepository cmdlet 中将 OverrideContentScanJob 参数设置为 on 时才相关。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-IncludeFileTypes

显式确定内容扫描作业扫描的文件类型。 使用逗号分隔的列表定义多个文件类型。

如果定义此参数,请将 ExcludeFileTypes 参数定义为 null。 例如,上面的 示例 4

仅在 Add-ScannerRepository 或 Set-ScannerRepository cmdlet 中将 OverrideContentScanJob 参数设置为 on 时才相关。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LabelFilesByContent

确定是启用或禁用“ 基于内容标签文件 ”扫描作业选项。

类型:OnOffEnum
接受的值:On, Off
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PreserveFileDetails

确定在扫描和自动标记时是否保留文件详细信息,包括修改日期、上次修改日期和由设置修改的日期。

类型:OnOffEnum
接受的值:On, Off
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RecommendedAsAutomatic

确定是否使用建议的标签来自动标记内容。

类型:OnOffEnum
接受的值:On, Off
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RelabelFiles

确定是否允许内容扫描作业重新标记文件。

提示

使用此参数时,请根据需要使用以下其他参数:

  • EnforceDefaultLabel
  • AllowLabelDowngrade
类型:OnOffEnum
接受的值:On, Off
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RepositoryOwner

指定 SAMAccountname (domain\user) 、UPN (user@domain) 或拥有存储库的组的 SID。

如果匹配的 DLP 规则更改了对文件的权限,则所有者将被授予对文件的完全控制权限。

仅当 EnableDlp 参数设置为 on 时才相关。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Schedule

确定内容扫描作业是按特定计划运行还是持续运行。

类型:Schedule
接受的值:Manual, Always
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 此 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None

输出

System.Object