Check-PurviewConfig
このコマンドレットは、セキュリティ/コンプライアンス PowerShell でのみ使用できます。 詳細については、「セキュリティ/コンプライアンス PowerShell」を参照してください。
Check-PurviewConfig コマンドレットを使用して、Microsoft Purview でorganizationの構成設定を検証および確認します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Check-PurviewConfig
[[-CaseHoldPolicyNameOrId] <String>]
[[-CaseId] <String>]
[[-Component] <PurviewConfigComponent>]
[-Confirm]
[[-DateTimeUTC] <String>]
[[-DeviceName] <String>]
[[-File] <String>]
[[-FileAsBytes] <Byte[]>]
[[-IncidentId] <String>]
[[-ItemId] <String>]
[[-MessageId] <String>]
[[-Organization] <OrganizationIdParameter>]
[[-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 コマンドレットを使用して、organizationの Microsoft Information Protection 診断テスト ケースを実行し、結果をチェックします。
Organization Configuration ロールが割り当てられている管理者は、このコマンドレットを実行するために必要なアクセス許可を持っています。
Microsoft Entra ID の管理者ロールのアクセス許可の詳細については、「ロール テンプレートの ID」を参照してください。
重要
Microsoft では、最小限のアクセス許可の原則を強くお勧めします。 アカウントにタスクを実行するために必要な最小限のアクセス許可のみを割り当てることは、セキュリティ リスクを軽減し、組織の全体的な保護を強化するのに役立ちます。 グローバル管理者は、通常は緊急時や別のロールを使用できない場合に限定する、非常に特権のあるロールです。
例
例 1
Check-PurviewConfig
この例では、追加のパラメーターを必要としないすべての Microsoft Information Protection テスト ケースを実行します。
例 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
この例では、UserPrincipalName 値を必要とする MipLabels_EnabledEntities_ScopedLabels という名前のテスト ケースを実行します。
例 5
Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels","MipLabels_EnabledEntities_CompareSyncStatus" -UserPrincipalName sathya@contoso.onmicrosoft.com
この例では、指定されたテスト ケースを実行します。 MipLabels_EnabledEntities_ScopedLabels テスト ケースには UserPrincipalName 値が必要です。
パラメーター
-CaseHoldPolicyNameOrId
適用対象: セキュリティ & コンプライアンス
{{ Fill CaseHoldPolicyNameOrId Description }}
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CaseId
適用対象: セキュリティ & コンプライアンス
{{ CaseId の説明を塗りつぶす }}
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Component
適用対象: セキュリティ & コンプライアンス
コンポーネント パラメーターは、テスト ケースで分析するコンポーネントを指定します。 有効な値は次のとおりです。
- DLP
- DLPAlerts
- 暗号化
- MIPLabels
パラメーターのプロパティ
| 型: | PurviewConfigComponent |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: セキュリティ & コンプライアンス
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| エイリアス: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DateTimeUTC
適用対象: セキュリティ & コンプライアンス
DateTimeUTC は、テスト ケースの日時を協定世界時 (UTC) で指定します。 たとえば、"2025-06-05 14:30:00" です。
このパラメーターは、次の TestCases 値に必要です。
- DlpAlerts_CheckAlertsCreated
- DlpAlerts_FindAlertForActivity
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DeviceName
適用対象: セキュリティ & コンプライアンス
{{ Fill DeviceName Description }}
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-File
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FileAsBytes
適用対象: セキュリティ & コンプライアンス
{{ fill: FileAsBytes description }}
パラメーターのプロパティ
| 型: | Byte[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 4 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-IncidentId
適用対象: セキュリティ & コンプライアンス
IncidentId パラメーターは、テスト ケースで分析するインシデントを指定します。
このパラメーターの値は、IncidentId プロパティの操作 DLPRuleMatch でフィルター処理された監査ログ検索で確認できます。
このパラメーターは、TestCases 値DlpAlerts_FindAlertForActivityに必要です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 3 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ItemId
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 4 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MessageId
適用対象: セキュリティ & コンプライアンス
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 5 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Organization
適用対象: セキュリティ & コンプライアンス
{{ 組織の説明を入力 }}
パラメーターのプロパティ
| 型: | OrganizationIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 10 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PolicyName
適用対象: セキュリティ & コンプライアンス
{{ Fill PolicyName Description }}
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 8 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RecipientAddress
適用対象: セキュリティ & コンプライアンス
{{ Fill RecipientAddress description }}
パラメーターのプロパティ
| 型: | SmtpAddress |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 9 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RecordId
適用対象: セキュリティ & コンプライアンス
RuleName パラメーターは、テスト ケースで分析するレコードを指定します。
このパラメーターの値は、アクティビティ エクスプローラーの RecordId プロパティのアクティビティ タイプ DLPRuleMatch でフィルタリングできます。
このパラメーターは、TestCases 値DlpAlerts_FindAlertForActivityでは省略可能です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 6 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RuleName
適用対象: セキュリティ & コンプライアンス
RuleName パラメーターは、テスト ケースで分析する DLP ルールを指定します。
このパラメーターは、TestCases 値DlpAlerts_CheckAlertsCreatedでは省略可能です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 7 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SenderAddress
適用対象: セキュリティ & コンプライアンス
{{ SenderAddress の説明を入力 }}
パラメーターのプロパティ
| 型: | SmtpAddress |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 12 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SharepointItemUniqueId
適用対象: セキュリティ & コンプライアンス
{{ Fill: SharepointItemUniqueId description }}
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 13 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SharepointSiteId
適用対象: セキュリティ & コンプライアンス
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 14 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SiteUrl
適用対象: セキュリティ & コンプライアンス
{{ Fill SiteUrl description }}
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 15 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SitIdentity
適用対象: セキュリティ & コンプライアンス
{{ Fill SitIdentity Description }}
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 16 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TestCases
適用対象: セキュリティ & コンプライアンス
TestCases パラメーターは、分析するテスト ケースの名前を指定します。 使用可能なテスト ケースとそれぞれの必須パラメーターを次のリストに示します。
- Encryption_EvaluationDetails: メール暗号化の評価の詳細を検証します。 その他のパラメーターは必要ありません。 チェックの一部としてコマンドレット Test-IRMConfiguration 実行します。
- Encryption_LicenseAvailability: メールの暗号化構成を確認します。 その他のパラメーターは必要ありません。 チェックの一部として Get-IRMConfiguration、Get-RMSTemplate、Get-TransportRule、および Get-JournalRule コマンドレットを実行します。
- MipLabels_EnabledEntities_ScopedLabels: ユーザーに適用されるラベルとラベル設定を表示します。 UserPrincipalName パラメーターが必要です。 チェックの一部として Get-Label および Get-LabelPolicy コマンドレットを実行します。
- MipLabels_LicenseAvailability: MIP ラベル機能が有効になっているかどうかを確認します。 その他のパラメーターは必要ありません。
- DlpAlerts_CheckAlertsCreated: 過去 5 日間に作成されたアラートの DLP ルール構成を検証します。 DateTimeUTC パラメーターが必要です。 RuleName パラメーターは省略可能です。
- DlpAlerts_FindAlertForActivity: アクティビティについて欠落しているアラートを特定します。 DateTimeUTC パラメーターが必要です。 IncidentId パラメーターと RecordId パラメーターは省略可能です。
- DLP_ScopedEntities: ユーザーまたはサイトに適用されるすべての DLP ポリシーとルールを返します。 ワークロード パラメーターが必要です。 SiteUrl パラメーターと UserPrincipalName パラメーターは省略可能です。
複数の値をコンマで区切って指定できます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 8 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Theme
適用対象: セキュリティ & コンプライアンス
テーマ パラメーター フィルターは、テスト ケースで分析するテーマを指定します。 有効な値は次のとおりです。
- EnabledEntities
- EvaluationDetails
- LicenseAvailability
パラメーターのプロパティ
| 型: | PurviewConfigTheme |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 9 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UserPrincipalName
適用対象: セキュリティ & コンプライアンス
UserPrincipalName パラメーターは、テスト ケースで分析するユーザー アカウント ( sathya@contoso.onmicrosoft.com など) を指定します。
- TestCases 値MipLabels_EnabledEntities_ScopedLabelsに必要です。
- TestCases 値DLP_ScopedEntitiesでは省略可能です。
パラメーターのプロパティ
| 型: | SmtpAddress |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 10 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: セキュリティ & コンプライアンス
WhatIf スイッチは、セキュリティ/コンプライアンス PowerShell では機能しません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| エイリアス: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Workload
適用対象: セキュリティ & コンプライアンス
ワークロード パラメーターは、サービス ワークロードを指定します。 値の値は次のとおりです。
- EndpointDevices
- Exchange
- OneDriveForBusiness
- SharePoint
- Teams
このパラメーターは、TestCases 値DLP_ScopedEntitiesに必要です。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 11 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。