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 la conformité 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)
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 agrégé. Si seuls les paramètres TagName et TagType sont utilisés, la valeur est le nombre total d’agrégats pour cette balise. Si le paramètre Workload 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 est le nombre de ce dossier spécifique.
- MorePagesAvailable : indique s’il reste plus d’enregistrements à exporter. La valeur est True ou False.
- RecordsReturned : nombre d’enregistrements retournés dans la requête.
- PageCookie : permet d’obtenir le jeu d’enregistrements suivant lorsque MorePagesAvailable a la valeur True.
- Enregistre les données : la sortie de cette applet de commande est un tableau. À partir de l’élément de tableau 1, contient des 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 SIT/Étiquettes. Au lieu de cela, créez un script pour un sit/label, puis réutiliser le même script pour chaque SIT/Étiquette dans chaque charge de travail en fonction des besoins.
Lorsque vous réessayez le script, veillez d’abord à vous reconnecter à la session. Le jeton de la session expire après environ une heure, 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 dernier cookie de page retourné pour poursuivre l’exportation à partir de 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 content Explorer à l’identité du 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 des enregistrements pour le type d’informations sensibles spécifié à partir de la boîte aux lettres d’Erika.
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 des enregistrements pour le type d’informations sensibles spécifié pour toutes les charges de travail.
Paramètres
-Aggregate
Applicable : Sécurité & Conformité
Note: 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 Aggregate retourne les nombres agrégés au niveau du dossier au lieu de retourner 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 d’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 retourne les informations suivantes :
- SharePoint et OneDrive : liste des SitesUlrs.
- Exchange Online et Microsoft Teams : liste des UPN.
- Nombre d’éléments dans les dossiers marqués d’une balise 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 pour les détails du fichier à exporter. Les valeurs valides sont les suivantes :
- bas
- medium
- haut
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 commande est True. Si vous n’utilisez pas le paramètre PageSize, un maximum de 100 enregistrements sont retournés. Si vous utilisez le paramètre PageSize, un maximum de 10 000 enregistrements peuvent être retourné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 10 000. La valeur par défaut est 100.
Remarque : Dans les dossiers vides ou les dossiers avec peu de fichiers, ce paramètre peut entraîner l’exécution de la commande pendant une longue période, car il tente d’obtenir le nombre PageSize des résultats. Pour éviter ce problème, la commande retourne les données de 5 dossiers ou le nombre d’enregistrements spécifiés par le paramètre PageSize, selon la première fois qui se termine. Par exemple, s’il existe 10 dossiers avec 1 enregistrement chacun, la commande retourne 5 enregistrements des 5 premiers dossiers. Lors de 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 du message. Un 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 Workload 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 courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.