Check-PurviewConfig
此 cmdlet 仅在安全与合规中心 PowerShell 内可用。 有关更多信息，请参见 安全与合规中心 PowerShell。
使用 Check-PurviewConfig cmdlet 在 Microsoft Purview 中验证和查看组织的配置设置。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default （默认值）
Check-PurviewConfig
[[-Component] <PurviewConfigComponent>]
[-Confirm]
[[-DateTimeUTC] <String>]
[[-DeviceName] <String>]
[[-File] <String>]
[[-FileAsBytes] <Byte[]>]
[[-IncidentId] <String>]
[[-ItemId] <String>]
[[-MessageId] <String>]
[[-PolicyName] <String>]
[-RecipientAddress]
[[-RecordId] <String>]
[[-RuleName] <String>]
[[-SenderAddress] <SmtpAddress>]
[[-SharepointItemUniqueId] <String>]
[[-SharepointSiteId] <String>]
[[-SiteUrl] <String>]
[[-SitIdentity] <String>]
[[-TestCases] <String[]>]
[[-Theme] <PurviewConfigTheme>]
[[-UserPrincipalName] <SmtpAddress>]
[-WhatIf]
[[-Workload] <String>]
[<CommonParameters>]
说明
使用 Check-PurviewConfig cmdlet 为组织运行Microsoft信息保护诊断测试用例，并检查结果。
分配有组织配置角色的管理员具有运行此 cmdlet 所需的权限。
若要详细了解Microsoft Entra ID 中的管理员角色权限，请参阅角色模板 ID。
重要
Microsoft强烈主张最低特权原则。 仅向帐户分配执行其任务所需的最低权限有助于降低安全风险，并增强组织的整体保护。 全局管理员是一种高特权角色，通常限制在紧急情况下或无法使用其他角色时使用。
示例
示例 1
Check-PurviewConfig
此示例运行不需要其他参数的所有Microsoft信息保护测试用例。
示例 2
Check-PurviewConfig -Component Encryption
此示例运行加密组件的所有测试用例。
示例 3
Check-PurviewConfig -Component Encryption -Theme LicenseAvailability
本示例运行加密组件中 LicenseAvailability 主题的所有案例。
示例 4
Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels" -UserPrincipalName sathya@contoso.onmicrosoft.com
此示例运行名为 MipLabels_EnabledEntities_ScopedLabels 的测试用例，该用例需要 UserPrincipalName 值。
示例 5
Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels","MipLabels_EnabledEntities_CompareSyncStatus" -UserPrincipalName sathya@contoso.onmicrosoft.com
此示例运行指定的测试用例。 MipLabels_EnabledEntities_ScopedLabels测试用例需要 UserPrincipalName 值。
参数
-Component
适用：安全 & 合规性
Component 参数指定要在测试用例中分析的组件。 有效值包含:
- DLP
- DLPAlerts
- 加密
- MIPLabels
参数属性
| 类型: | PurviewConfigComponent |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
适用：安全 & 合规性
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DateTimeUTC
适用：安全 & 合规性
DateTimeUTC 以协调世界时 (UTC) 指定测试用例的日期时间。 例如，“2025-06-05 14：30：00”。
以下 TestCases 值需要此参数：
- DlpAlerts_CheckAlertsCreated
- DlpAlerts_FindAlertForActivity
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DeviceName
适用：安全 & 合规性
{{ Fill DeviceName Description }}
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 2 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-File
适用：安全 & 合规性
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 2 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FileAsBytes
适用：安全 & 合规性
{{ Fill FileAsBytes Description }}
参数属性
| 类型: | Byte[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 4 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IncidentId
适用：安全 & 合规性
IncidentId 参数指定要在测试用例中分析的事件。
可以在 IncidentId 属性中按 DLPRuleMatch作筛选的审核日志搜索中找到此参数的值。
此参数是 TestCases 值DlpAlerts_FindAlertForActivity所必需的。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 3 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ItemId
适用：安全 & 合规性
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 4 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MessageId
适用：安全 & 合规性
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 5 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PolicyName
适用：安全 & 合规性
{{ Fill PolicyName Description }}
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 8 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-RecipientAddress
适用：安全 & 合规性
{{ Fill RecipientAddress Description }}
参数属性
| 类型: | SmtpAddress |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 9 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-RecordId
适用：安全 & 合规性
RuleName 参数指定要在测试用例中分析的记录。
可以在 RecordId 属性中按活动类型 DLPRuleMatch 筛选的活动资源管理器中找到此参数的值。
此参数是可选的，testCases 值DlpAlerts_FindAlertForActivity。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 6 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-RuleName
适用：安全 & 合规性
RuleName 参数指定要在测试用例中分析的 DLP 规则。
此参数是可选的，DlpAlerts_CheckAlertsCreated TestCases 值。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 7 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SenderAddress
适用：安全 & 合规性
{{ Fill SenderAddress Description }}
参数属性
| 类型: | SmtpAddress |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 12 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SharepointItemUniqueId
适用：安全 & 合规性
{{ Fill SharepointItemUniqueId Description }}
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 13 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SharepointSiteId
适用：安全 & 合规性
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 14 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SiteUrl
适用：安全 & 合规性
{{ Fill SiteUrl Description }}
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 15 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SitIdentity
适用：安全 & 合规性
{{ Fill SitIdentity Description }}
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 16 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-TestCases
适用：安全 & 合规性
TestCases 参数指定要分析的测试用例的名称。 以下列表中介绍了可用的测试用例及其所需参数：
- Encryption_EvaluationDetails：验证电子邮件加密评估详细信息。 不需要其他参数。 运行 Test-IRMConfiguration cmdlet 作为其检查的一部分。
- Encryption_LicenseAvailability：检查电子邮件加密配置。 不需要其他参数。 运行 Get-IRMConfiguration、Get-RMSTemplate、Get-TransportRule 和 Get-JournalRule cmdlet 作为其检查的一部分。
- MipLabels_EnabledEntities_ScopedLabels：显示应用于用户的标签和标签设置。 需要 UserPrincipalName 参数。 在检查过程中运行 Get-Label 和 Get-LabelPolicy cmdlet。
- MipLabels_LicenseAvailability：验证是否启用了 MIP 标签功能。 无需其他参数。
- DlpAlerts_CheckAlertsCreated：验证过去 5 天内创建的警报的 DLP 规则配置。 需要 DateTimeUTC 参数。 RuleName 参数是可选的。
- DlpAlerts_FindAlertForActivity：标识活动缺少的警报。 需要 DateTimeUTC 参数。 IncidentId 和 RecordId 参数是可选的。
- DLP_ScopedEntities：返回应用于用户或站点的所有 DLP 策略和规则。 需要 Workload 参数。 SiteUrl 和 UserPrincipalName 参数是可选的。
可以指定用逗号分隔的多个值。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 8 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Theme
适用：安全 & 合规性
Theme 参数筛选器指定要在测试用例中分析的筛选器。 有效值包含:
- EnabledEntities
- EvaluationDetails
- LicenseAvailability
参数属性
| 类型: | PurviewConfigTheme |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 9 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-UserPrincipalName
适用：安全 & 合规性
UserPrincipalName 参数指定要在测试用例 (分析的用户帐户， sathya@contoso.onmicrosoft.com 例如，) 。
- TestCases 值MipLabels_EnabledEntities_ScopedLabels所必需的。
- TestCases 值DLP_ScopedEntities可选。
参数属性
| 类型: | SmtpAddress |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 10 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：安全 & 合规性
WhatIf 开关在安全与合规 PowerShell 中不起作用。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Workload
适用：安全 & 合规性
Workload 参数指定服务工作负荷。 值为：
- EndpointDevices
- Exchange
- OneDriveForBusiness
- SharePoint
- Teams
此参数是 TestCases 值DLP_ScopedEntities所必需的。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 11 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。