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>]
Description
使用 Check-PurviewConfig Cmdlet 為您的組織執行Microsoft資訊保護診斷測試案例，並檢查結果。
指派組織設定角色的系統管理員具有執行此 Cmdlet 的必要許可權。
若要深入瞭解 Microsoft Entra ID 中的系統管理員角色許可權，請參閱 角色範本識別碼。
重要事項
Microsoft 強烈提倡最小權限原則。 僅為帳戶指派執行其任務所需的最低權限，有助於降低安全風險並加強組織的整體保護。 全域管理員是高度許可權的角色，您通常會將其限制為緊急情況或當您無法使用其他角色時。
範例
範例 1
Check-PurviewConfig
此範例會執行不需要其他參數的所有 Microsoft 資訊保護測試案例。
範例 2
Check-PurviewConfig -Component Encryption
此範例會執行加密元件的所有測試案例。
範例 3
Check-PurviewConfig -Component Encryption -Theme LicenseAvailability
此範例會在 Encryption 元件中執行 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
適用：安全 & 合規
元件參數指定要在測試案例中分析的元件。 有效值為：
- DLP
- DLP成員
- 加密
- 米普拉貝爾
參數屬性
| 類型: | PurviewConfigComponent |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
適用：安全 & 合規
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 參閱 |
參數集
(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
適用：安全 & 合規
{{ 填入裝置名稱說明 }}
參數屬性
| 類型: | 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 說明 }}
參數屬性
| 類型: | 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
適用：安全 & 合規
{{ 填寫原則名稱說明 }}
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 8 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RecipientAddress
適用：安全 & 合規
{{ 填寫收件者地址說明 }}
參數屬性
| 類型: | 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 規則。
此參數是 TestCases 值DlpAlerts_CheckAlertsCreated的選用項目。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 7 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SenderAddress
適用：安全 & 合規
{{ 填寫發件人地址描述 }}
參數屬性
| 類型: | SmtpAddress |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 12 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SharepointItemUniqueId
適用：安全 & 合規
{{ Fill SharepointItemUniqueId 描述 }}
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 13 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SharepointSiteId
適用：安全 & 合規
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 14 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SiteUrl
適用：安全 & 合規
{{ 填寫 SiteUrl 說明 }}
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 15 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SitIdentity
適用：安全 & 合規
{{ 填寫 SitIdentity 說明 }}
參數屬性
| 類型: | 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 原則和規則。 需要工作負載參數。 SiteUrl 和 UserPrincipalName 參數是選擇性的。
您可以指定多個以逗號分隔的值。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 8 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Theme
適用：安全 & 合規
主題參數篩選器會指定要在測試案例中分析的篩選器。 有效值為：
- 啟用實體
- 評估詳情
- 授權可用性
參數屬性
| 類型: | 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
適用：安全 & 合規
工作負載參數指定服務工作負載。 值值為：
- 端點裝置
- 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。