Set-ScannerContentScan
定义 Microsoft Purview 信息保护扫描程序内容扫描作业的设置。
语法
Default (默认值)
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]
说明
定义内容扫描作业的配置,该作业根据定义的设置扫描定义的存储库中的内容。 有关内容扫描作业的详细信息,请参阅 Microsoft Purview 信息保护本地扫描程序文档。
示例
示例 1:定义默认内容扫描作业设置
PS C:\WINDOWS\system32> Set-ScannerContentScan -Enforce Off
此示例使用默认设置定义内容扫描作业,并将 Policy enforcement (策略实施 ) 选项设置为 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 |
| 默认值: | None |
| 接受的值: | On, Off |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前,提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DefaultLabelId
定义使用默认标签自动标记内容时使用的默认标签的 ID。
如果 DefaultLabelType 参数设置为 custom,则为 必填项。
参数属性
| 类型: | Guid |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DefaultLabelType
确定使用默认标签自动标记内容时使用的默认标签类型。
使用时,使用 DefaultLabelId 参数定义要用作默认 ID 的标签 ID。
参数属性
| 类型: | DefaultLabelType |
| 默认值: | None |
| 接受的值: | None, PolicyDefault, Custom |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DefaultOwner
使用账户电子邮件地址定义用于扫描的文件的默认所有者值。 默认情况下,这是 scanner 帐户。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DiscoverInformationTypes
确定在内容扫描作业期间发现的信息类型的类型。
参数属性
| 类型: | DiscoverInformationTypes |
| 默认值: | None |
| 接受的值: | PolicyOnly, All |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-EnableDlp
确定内容扫描作业在扫描内容时是否使用数据丢失防护 (DLP) 敏感度信息类型。
小窍门
如果配置此参数,则可能还需要使用 RepositoryOwner 参数配置特定的存储库所有者。
参数属性
| 类型: | OnOffEnum |
| 默认值: | None |
| 接受的值: | On, Off |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Enforce
确定内容扫描作业是否根据您的策略强制执行内容扫描和标记。
参数属性
| 类型: | OnOffEnum |
| 默认值: | None |
| 接受的值: | On, Off |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-EnforceDefaultLabel
确定在重新标记内容时是否始终使用默认标签。
仅当 RelabelFiles 参数设置为 on 时才相关。
参数属性
| 类型: | OnOffEnum |
| 默认值: | None |
| 接受的值: | On, Off |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExcludeFileTypes
确定在内容扫描作业期间忽略的任何文件类型。 使用逗号分隔的列表定义多个文件类型。
如果定义此参数,请将 IncludeFileTypes 参数定义为 null。 例如,上面的 示例 4 。
仅当 Add-ScannerRepository 或 Set-ScannerRepository cmdlet 中的 OverrideContentScanJob 参数设置为 on 时才相关。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-IncludeFileTypes
显式确定内容扫描作业扫描的文件类型。 使用逗号分隔的列表定义多个文件类型。
如果定义此参数,请将 ExcludeFileTypes 参数定义为 null。 例如,上面的 示例 4 。
仅当 Add-ScannerRepository 或 Set-ScannerRepository cmdlet 中的 OverrideContentScanJob 参数设置为 on 时才相关。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-LabelFilesByContent
确定 Label files based on content scan job 选项是启用还是禁用。
参数属性
| 类型: | OnOffEnum |
| 默认值: | None |
| 接受的值: | On, Off |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PreserveFileDetails
确定在扫描和自动标记时是否保留文件详细信息,包括修改日期、上次修改时间和修改者设置。
参数属性
| 类型: | OnOffEnum |
| 默认值: | None |
| 接受的值: | On, Off |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-RecommendedAsAutomatic
确定是否使用建议的标签来自动标记您的内容。
参数属性
| 类型: | OnOffEnum |
| 默认值: | None |
| 接受的值: | On, Off |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-RelabelFiles
确定是否允许内容扫描作业重新标记文件。
小窍门
使用此参数时,请根据需要使用以下附加参数:
- EnforceDefaultLabel
- 允许标签降级
参数属性
| 类型: | OnOffEnum |
| 默认值: | None |
| 接受的值: | On, Off |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-RepositoryOwner
指定拥有存储库的组的 SAMAccountname (domain\user)、UPN (user@domain) 或 SID。
如果匹配的 DLP 规则更改了文件的权限,则所有者将被授予对文件的完全控制权限。
仅当 EnableDlp 参数设置为 on 时才相关。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Schedule
确定内容扫描作业是根据特定计划运行,还是连续运行。
参数属性
| 类型: | Schedule |
| 默认值: | None |
| 接受的值: | Manual, Always |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |