Check-PurviewConfig
Cette cmdlet est disponible uniquement dans le Centre de conformité et sécurité PowerShell. Si vous souhaitez en savoir plus, veuillez consulter l’article Centre de conformité et sécurité PowerShell.
Utilisez l’applet de commande Check-PurviewConfig pour valider et passer en revue les paramètres de configuration de votre organization dans Microsoft Purview.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
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
Utilisez l’applet de commande Check-PurviewConfig pour exécuter des cas de test de diagnostic Microsoft Information Protection pour votre organization et case activée les résultats.
Les administrateurs auxquels le rôle Configuration de l’organisation est attribué disposent des autorisations nécessaires pour exécuter cette applet de commande.
Pour en savoir plus sur les autorisations de rôle d’administrateur dans Microsoft Entra ID, consultez ID de modèle de rôle.
Importante
Microsoft défend fermement le principe des privilèges minimum. L’attribution de comptes uniquement les autorisations minimales nécessaires à l’exécution de leurs tâches permet de réduire les risques de sécurité et renforce la protection globale de votre organization. Administrateur général est un rôle hautement privilégié que vous limitez généralement aux scénarios d’urgence ou lorsque vous ne pouvez pas utiliser un autre rôle.
Exemples
Exemple 1
Check-PurviewConfig
Cet exemple exécute tous les cas de test Microsoft Information Protection qui ne nécessitent pas de paramètres supplémentaires.
Exemple 2
Check-PurviewConfig -Component Encryption
Cet exemple exécute tous les cas de test pour le composant Chiffrement.
Exemple 3
Check-PurviewConfig -Component Encryption -Theme LicenseAvailability
Cet exemple exécute tous les cas pour le thème LicenseAvailability dans le composant Chiffrement.
Exemple 4
Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels" -UserPrincipalName sathya@contoso.onmicrosoft.com
Cet exemple exécute le cas de test nommé MipLabels_EnabledEntities_ScopedLabels, qui nécessite une valeur UserPrincipalName.
Exemple 5
Check-PurviewConfig -TestCases "MipLabels_EnabledEntities_ScopedLabels","MipLabels_EnabledEntities_CompareSyncStatus" -UserPrincipalName sathya@contoso.onmicrosoft.com
Cet exemple exécute les cas de test spécifiés. Une valeur UserPrincipalName est requise pour le cas de test MipLabels_EnabledEntities_ScopedLabels.
Paramètres
-Component
Applicable : Sécurité & Conformité
Le paramètre Component spécifie le composant à analyser dans le cas de test. Les valeurs valides sont les suivantes :
- DLP
- DLPAlerts
- Chiffrement
- MIPLabels
Propriétés du paramètre
| Type: | PurviewConfigComponent |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : Sécurité & Conformité
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DateTimeUTC
Applicable : Sécurité & Conformité
DateTimeUTC spécifie la date-heure du cas de test en temps universel coordonné (UTC). Par exemple, « 2025-06-05 14:30:00 ».
Ce paramètre est requis pour les valeurs TestCases suivantes :
- DlpAlerts_CheckAlertsCreated
- DlpAlerts_FindAlertForActivity
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DeviceName
Applicable : Sécurité & Conformité
{{ Fill DeviceName Description }}
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-File
Applicable : Sécurité & Conformité
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-FileAsBytes
Applicable : Sécurité & Conformité
{{ Fill FileAsBytes Description }}
Propriétés du paramètre
| Type: | Byte[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 4 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IncidentId
Applicable : Sécurité & Conformité
Le paramètre IncidentId spécifie l’incident à analyser dans le cas de test.
Vous trouverez une valeur pour ce paramètre dans les recherches dans les journaux d’audit filtrées par l’opération DLPRuleMatch dans la propriété IncidentId.
Ce paramètre est requis pour la valeur TestCases DlpAlerts_FindAlertForActivity.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 3 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ItemId
Applicable : Sécurité & Conformité
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 4 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MessageId
Applicable : Sécurité & Conformité
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 5 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PolicyName
Applicable : Sécurité & Conformité
{{ Fill PolicyName Description }}
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 8 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RecipientAddress
Applicable : Sécurité & Conformité
{{ Fill RecipientAddress Description }}
Propriétés du paramètre
| Type: | SmtpAddress |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 9 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RecordId
Applicable : Sécurité & Conformité
Le paramètre RuleName spécifie l’enregistrement à analyser dans le cas de test.
Vous trouverez une valeur pour ce paramètre dans Activity Explorer filtrée par le type d’activité DLPRuleMatch dans la propriété RecordId.
Ce paramètre est facultatif avec la valeur TestCases DlpAlerts_FindAlertForActivity.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 6 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RuleName
Applicable : Sécurité & Conformité
Le paramètre RuleName spécifie la règle DLP à analyser dans le cas de test.
Ce paramètre est facultatif avec la valeur TestCases DlpAlerts_CheckAlertsCreated.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 7 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SenderAddress
Applicable : Sécurité & Conformité
{{ Fill SenderAddress Description }}
Propriétés du paramètre
| Type: | SmtpAddress |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 12 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SharepointItemUniqueId
Applicable : Sécurité & Conformité
{{ Fill SharepointItemUniqueId Description }}
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 13 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SharepointSiteId
Applicable : Sécurité & Conformité
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 14 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SiteUrl
Applicable : Sécurité & Conformité
{{ Fill SiteUrl Description }}
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 15 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SitIdentity
Applicable : Sécurité & Conformité
{{ Fill SitIdentity Description }}
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 16 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TestCases
Applicable : Sécurité & Conformité
Le paramètre TestCases spécifie le nom du cas de test à analyser. Les cas de test disponibles et leurs paramètres requis sont décrits dans la liste suivante :
- Encryption_EvaluationDetails : valide les détails de l’évaluation du chiffrement des e-mails. Aucun autre paramètre n’est requis. Exécute Test-IRMConfiguration cmdlet dans le cadre de ses vérifications.
- Encryption_LicenseAvailability : vérifie les configurations de chiffrement des e-mails. Aucun autre paramètre n’est requis. Exécute les applets de commande Get-IRMConfiguration, Get-RMSTemplate, Get-TransportRule et Get-JournalRule dans le cadre de ses vérifications.
- MipLabels_EnabledEntities_ScopedLabels : affiche les étiquettes et les paramètres d’étiquette qui s’appliquent à un utilisateur. Nécessite le paramètre UserPrincipalName. Exécute Get-Label et Get-LabelPolicy applets de commande dans le cadre de ses vérifications.
- MipLabels_LicenseAvailability : vérifie si la fonctionnalité Étiquette MIP est activée. Aucun autre paramètre n’est requis.
- DlpAlerts_CheckAlertsCreated : valide la configuration de la règle DLP pour les alertes créées au cours des 5 derniers jours. Nécessite le paramètre DateTimeUTC. Le paramètre RuleName est facultatif.
- DlpAlerts_FindAlertForActivity : identifie les alertes manquantes pour une activité. Nécessite le paramètre DateTimeUTC. Les paramètres IncidentId et RecordId sont facultatifs.
- DLP_ScopedEntities : retourne toutes les stratégies et règles DLP qui s’appliquent à un utilisateur ou à un site. Nécessite le paramètre Workload. Les paramètres SiteUrl et UserPrincipalName sont facultatifs.
Vous pouvez spécifier plusieurs valeurs séparées par des virgules.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 8 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Theme
Applicable : Sécurité & Conformité
Les filtres du paramètre Theme spécifient les éléments à analyser dans le cas de test. Les valeurs valides sont les suivantes :
- EnabledEntities
- EvaluationDetails
- LicenseAvailability
Propriétés du paramètre
| Type: | PurviewConfigTheme |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 9 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-UserPrincipalName
Applicable : Sécurité & Conformité
Le paramètre UserPrincipalName spécifie le compte d’utilisateur à analyser dans le cas de test (par exemple, sathya@contoso.onmicrosoft.com).
- Obligatoire pour la valeur TestCases MipLabels_EnabledEntities_ScopedLabels.
- Facultatif pour la valeur TestCases DLP_ScopedEntities.
Propriétés du paramètre
| Type: | SmtpAddress |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 10 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Sécurité & Conformité
Le commutateur WhatIf ne fonctionne pas dans le Centre de sécurité et de conformité PowerShell.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Workload
Applicable : Sécurité & Conformité
Le paramètre Workload spécifie la charge de travail de service. Les valeurs de valeur sont les suivantes :
- EndpointDevices
- Exchange
- OneDriveForBusiness
- SharePoint
- Équipes
Ce paramètre est requis pour la valeur TestCases DLP_ScopedEntities.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 11 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.