Export-ContentExplorerData
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 Export-ContentExplorerData pour exporter les détails du fichier de classification des données dans Microsoft Purview compliance.
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)
Export-ContentExplorerData
[-TagName] <String>
[-TagType] <String>
[-Aggregate]
[[-ConfidenceLevel] <String>]
[[-PageCookie] <String>]
[[-PageSize] <Int32>]
[[-SiteUrl] <String>]
[[-UserPrincipalName] <String>]
[[-Workload] <String>]
[<CommonParameters>]
Description
Le résultat de cette cmdlet contient les informations suivantes :
- TotalCount : nombre d’agrégats. Si vous utilisez uniquement les paramètres TagName et TagType, la valeur correspond au nombre total d’agrégats pour cette balise. Si le paramètre Charge de travail est également utilisé, la valeur est le nombre agrégé dans la charge de travail pour cette balise. Si les paramètres UserPrincipalName ou SiteUrl sont utilisés, la valeur correspond au nombre de ce dossier spécifique.
- MorePagesAvailable : indique s’il reste d’autres enregistrements à exporter. La valeur est True ou False.
- RecordsReturned : nombre d’enregistrements renvoyés dans la requête.
- PageCookie : utilisé pour obtenir le jeu d’enregistrements suivant lorsque MorePagesAvailable a la valeur True.
- Données d’enregistrement : la sortie de cette applet de commande est un tableau. À partir de l’élément de tableau 1, contient les données d’enregistrements
La liste suivante décrit les meilleures pratiques pour les scripts utilisant cette applet de commande :
Nous vous recommandons de ne pas utiliser un seul script pour exporter plusieurs SITs/étiquettes. Créez plutôt un script pour un SIT/Label, puis réutilisez le même script pour chaque SIT/Label dans chaque charge de travail si nécessaire.
Si vous réessayez d’exécuter le script, veillez tout d’abord à vous reconnecter à la session. Le jeton de la session expire au bout d’une heure environ, ce qui peut entraîner l’échec de l’applet de commande. Pour résoudre ce problème, reconnectez-vous à la session avant de réessayer le script. Si le script échoue, redémarrez-le à l’aide du cookie de la dernière page renvoyé pour continuer l’exportation là où il s’est arrêté.
Conseil
Pour prendre en charge les scripts sans assistance qui s’exécutent pendant une longue période, vous pouvez utiliser l’authentification basée sur les certificats (CBA).
Pour utiliser l’application Azure, ajoutez le groupe de rôles Visionneuse de liste de Explorer de contenu à l’identité de principal du service.
Pour pouvoir utiliser cette cmdlet dans le Centre de sécurité et de conformité PowerShell, des autorisations doivent vous être attribuées. Pour plus d’informations, consultez la rubrique Autorisations dans le portail de conformité Microsoft Purview.
Exemples
Exemple 1
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload EXO -UserPrincipalName erika@contoso.onmicrosoft.com
Cet exemple exporte les enregistrements de la boîte aux lettres d’Erika pour le type d’informations sensibles spécifié.
Exemple 2
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload ODB -SiteUrl https://contoso-my.sharepoint.com/personal/erika_contoso_onmicrosoft_com
Cet exemple exporte des enregistrements pour le type d’informations sensibles spécifié dans le site OneDrive d’Erika.
Exemple 3
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names"
Exemple 4
$Report = @()
$Content = Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names" -ConfidenceLevel high -Workload sharepoint -PageSize 1000
[string]$PageCookie = $Content.PageCookie
$Report += $Content[1..$Content[0].RecordsReturned]
while($PageCookie -notlike " * ")
{
$NewContent = Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names" -ConfidenceLevel high -Workload sharepoint -PageCookie $PageCookie -PageSize 1000
[string]$PageCookie = $NewContent.PageCookie
$Report += $NewContent[1..$NewContent[0].RecordsReturned]
}
$Report | Export-CSV C:\temp\CE_Report-AFN_high.csv -Encoding UTF8 -NoTypeInformation
Cet exemple exporte les enregistrements du type d’informations sensibles spécifié pour toutes les charges de travail.
Paramètres
-Aggregate
Applicable : sécurité & conformité
Remarque : Ce paramètre est actuellement en préversion privée, n’est pas disponible dans toutes les organisations et est susceptible d’être modifié.
Le commutateur de paramètre Agrégat renvoie les nombres agrégés au niveau du dossier au lieu de renvoyer des détails au niveau de l’élément. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
L’utilisation de ce commutateur réduit considérablement le temps d’exportation. Pour télécharger les éléments dans un dossier, exécutez cette applet de commande pour des dossiers spécifiques.
Lorsque vous utilisez ce commutateur avec les paramètres TagName, TagType et Workload, la commande renvoie les informations suivantes :
- SharePoint et OneDrive : la liste des SiteUlrs.
- Exchange Online et Microsoft Teams : liste des UPN.
- Nombre d’éléments dans les dossiers estampillés avec l’étiquette appropriée.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
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 |
-ConfidenceLevel
Applicable : sécurité & conformité
Le paramètre ConfidenceLevel spécifie le niveau de confiance de la correspondance des détails du fichier à exporter. Les valeurs valides sont les suivantes :
- Faible
- medium
- Plus élevé
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Valeurs acceptées: | high, medium, low |
| 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 |
-PageCookie
Applicable : sécurité & conformité
Le paramètre PageCookie spécifie s’il faut obtenir plus de données lorsque la valeur de la propriété MorePagesAvailable dans la sortie de la commande est True. Si vous n’utilisez pas le paramètre PageSize, un maximum de 100 enregistrements est renvoyé. Si vous utilisez le paramètre PageSize, un maximum de 10000 enregistrements peuvent être renvoyés.
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 |
-PageSize
Applicable : sécurité & conformité
Le paramètre PageSize spécifie le nombre maximal d’enregistrements à retourner dans une seule requête. L’entrée valide pour ce paramètre est un entier compris entre 1 et 10000. La valeur par défaut est 100.
Remarque : Dans les dossiers vides ou avec peu de fichiers, ce paramètre peut entraîner l’exécution de la commande pendant une longue période car elle essaie d’obtenir le nombre PageSize des résultats. Pour éviter ce problème, la commande renvoie les données de 5 dossiers ou du nombre d’enregistrements spécifié par le paramètre PageSize, selon la première occurrence terminée. Par exemple, s’il existe 10 dossiers avec 1 enregistrement chacun, la commande renvoie 5 enregistrements des 5 premiers dossiers. Dans l’exécution suivante à l’aide du cookie de page, il retourne 5 enregistrements des 5 dossiers restants, même si la valeur PageSize est 10.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | 0 |
| 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 |
-SiteUrl
Applicable : sécurité & conformité
Le paramètre SiteUrl spécifie l’URL du site à partir de laquelle exporter les détails du fichier.
Vous utilisez ce paramètre pour les charges de travail SharePoint et OneDrive.
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 |
-TagName
Applicable : sécurité & conformité
Le paramètre TagName spécifie le nom de l’étiquette à partir de laquelle exporter les détails du fichier. Si la valeur contient des espaces, mettez le nom entre guillemets.
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: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TagType
Applicable : sécurité & conformité
Le paramètre TagType spécifie le type d’étiquette à partir duquel exporter les détails du fichier. Les valeurs valides sont les suivantes :
- Rétention
- SensitiveInformationType
- Niveau de confidentialité
- TrainableClassifier
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: | True |
| 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 au format UPN à partir duquel exporter les détails des messages. Exemple de valeur UPN est erika@contoso.onmicrosoft.com.
Vous utilisez ce paramètre pour les charges de travail Exchange et Microsoft Teams.
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 |
-Workload
Applicable : sécurité & conformité
Le paramètre Charge de travail spécifie l’emplacement à partir duquel exporter les détails du fichier. Les valeurs valides sont les suivantes :
- EXO ou Exchange
- ODB ou OneDrive
- SPO ou SharePoint
- Teams
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 |
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.