Export-ContentExplorerData
Hinweis: Dieses Cmdlet befindet sich derzeit in der Vorschau und kann geändert werden.
Dieses Cmdlet ist nur im Security & Compliance Center-PowerShell verfügbar. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.
Verwenden Sie das Cmdlet Export-ContentExplorerData, um Datenklassifizierungsdateidetails in Microsoft Purview-Compliance zu exportieren.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Export-ContentExplorerData
[-TagName] <String>
[-TagType] <String>
[-Aggregate]
[[-PageCookie] <String>]
[[-PageSize] <Int32>]
[[-SiteUrl] <String>]
[[-UserPrincipalName] <String>]
[[-Workload] <String>]
[<CommonParameters>] Beschreibung
Die Ausgabe dieses Cmdlets enthält die folgenden Informationen:
- TotalCount: Aggregierte Anzahl. Wenn nur die Parameter TagName und TagType verwendet werden, entspricht der Wert der Gesamtaggregatanzahl für dieses Tag. Wenn auch der Workload-Parameter verwendet wird, ist der Wert die aggregierte Anzahl in der Workload für dieses Tag. Wenn die Parameter UserPrincipalName oder SiteUrl verwendet werden, ist der Wert die Anzahl für diesen bestimmten Ordner.
- MorePagesAvailable: Zeigt an, ob noch weitere Datensätze zum Exportieren vorhanden sind. Der Wert ist True oder False.
- RecordsReturned: Die Anzahl der in der Abfrage zurückgegebenen Datensätze.
- PageCookie: Wird verwendet, um den nächsten Satz von Datensätzen abzurufen, wenn MorePagesAvailable auf True festgelegt ist.
In der folgenden Liste werden bewährte Methoden für Skripts beschrieben, die dieses Cmdlet verwenden:
Es wird empfohlen, zum Exportieren mehrerer SITs/Bezeichnungen kein einzelnes Skript zu verwenden. Erstellen Sie stattdessen ein Skript für eine SIT/Bezeichnung, und verwenden Sie dann dasselbe Skript für jede SIT/Bezeichnung in jeder Workload nach Bedarf erneut.
Stellen Sie beim Wiederholen des Skripts sicher, dass Sie zuerst erneut eine Verbindung mit der Sitzung herstellen. Das Token der Sitzung läuft nach etwa einer Stunde ab, was dazu führen kann, dass das Cmdlet fehlschlägt. Um dieses Problem zu beheben, stellen Sie erneut eine Verbindung mit der Sitzung her, bevor Sie das Skript wiederholen. Wenn das Skript fehlschlägt, starten Sie es mithilfe des letzten zurückgegebenen Seitencookies neu, um den Export dort fortzusetzen, wo es aufgehört hat.
Tipp
Um unbeaufsichtigte Skripts zu unterstützen, die über einen längeren Zeitraum ausgeführt werden, können Sie die zertifikatbasierte Authentifizierung (Certificate-Based Authentication, CBA) verwenden.
Um dieses Cmdlet in Security & Compliance PowerShell zu verwenden, müssen Ihnen Berechtigungen zugewiesen werden. Weitere Informationen finden Sie unter Berechtigungen im Microsoft Purview-Complianceportal.
Beispiele
Beispiel 1
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload EXO -UserPrincipalName erika@contoso.onmicrosoft.comIn diesem Beispiel werden Datensätze für den angegebenen Typ vertraulicher Informationen aus dem Postfach von Erika exportiert.
Beispiel 2
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "Credit Card Number" -Workload ODB -SiteUrl https://contoso-my.sharepoint.com/personal/erika_contoso_onmicrosoft_comIn diesem Beispiel werden Datensätze für den angegebenen Typ vertraulicher Informationen auf der OneDrive-Website von Erika exportiert.
Beispiel 3
Export-ContentExplorerData -TagType SensitiveInformationType -TagName "All Full Names"In diesem Beispiel werden Datensätze für den angegebenen Typ vertraulicher Informationen für alle Workloads exportiert.
Parameter
-Aggregate
Anmerkung: Dieser Parameter befindet sich derzeit in der privaten Vorschau, ist nicht in allen Organisationen verfügbar und kann geändert werden.
Der Parameterschalter Aggregate gibt die aggregierten Zahlen auf Ordnerebene zurück, anstatt Details auf Elementebene zurückzugeben. Sie müssen keinen Wert für diese Option angeben.
Die Verwendung dieses Schalters reduziert die Exportzeit erheblich. Führen Sie dieses Cmdlet für bestimmte Ordner aus, um die Elemente in einem Ordner herunterzuladen.
Wenn Sie diesen Schalter mit den Parametern TagName, TagType und Workload verwenden, gibt der Befehl die folgenden Informationen zurück:
- SharePoint und OneDrive: Die Liste der SiteUlrs.
- Exchange Online und Microsoft Teams: Die Liste der UPNs.
- Die Anzahl der Elemente in den Ordnern, die mit einem relevanten Tag gestempelt sind.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Security & Compliance |
-PageCookie
Der PageCookie-Parameter gibt an, ob weitere Daten abgerufen werden sollen, wenn der Wert der MorePagesAvailable-Eigenschaft in der Befehlsausgabe True ist. Wenn Sie den PageSize-Parameter nicht verwenden, werden maximal 100 Datensätze zurückgegeben. Wenn Sie den PageSize-Parameter verwenden, können maximal 10.000 Datensätze zurückgegeben werden.
| Typ: | String |
| Position: | 1 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Security & Compliance |
-PageSize
Der PageSize-Parameter gibt die maximale Anzahl von Datensätzen an, die in einer einzelnen Abfrage zurückgegeben werden sollen. Gültige Eingabe für diesen Parameter ist eine ganze Zahl zwischen 1 und 10.000. Der Standardwert ist 100.
Hinweis: In leeren Ordnern oder Ordnern mit wenigen Dateien kann dieser Parameter dazu führen, dass der Befehl lange ausgeführt wird, da er versucht, die PageSize-Anzahl der Ergebnisse abzurufen. Um dieses Problem zu verhindern, gibt der Befehl Daten aus 5 Ordnern oder die Anzahl von Datensätzen zurück, die durch den PageSize-Parameter angegeben werden, je nachdem, was zuerst abgeschlossen wird. Wenn beispielsweise 10 Ordner mit jeweils einem Datensatz vorhanden sind, gibt der Befehl 5 Datensätze der fünf obersten Ordner zurück. Bei der nächsten Ausführung mit Seitencookies werden fünf Datensätze aus den verbleibenden 5 Ordnern zurückgegeben, auch wenn der PageSize-Wert 10 ist.
| Typ: | Int32 |
| Position: | 2 |
| Standardwert: | 0 |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Security & Compliance |
-SiteUrl
Der Parameter SiteUrl gibt die Website-URL an, aus der Dateidetails exportiert werden sollen.
Sie verwenden diesen Parameter für SharePoint- und OneDrive-Workloads.
| Typ: | String |
| Position: | 3 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Security & Compliance |
-TagName
Der TagName-Parameter gibt den Namen der Bezeichnung an, aus der Dateidetails exportiert werden sollen. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
| Typ: | String |
| Position: | 4 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Security & Compliance |
-TagType
Der TagType-Parameter gibt den Typ der Bezeichnung an, aus der Dateidetails exportiert werden sollen. Gültige Werte sind:
- Aufbewahrung
- SensitiveInformationType
- Sensitivity
- TrainableClassifier
| Typ: | String |
| Position: | 5 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Security & Compliance |
-UserPrincipalName
Der Parameter UserPrincipalName gibt das Benutzerkonto im UPN-Format an, aus dem Nachrichtendetails exportiert werden sollen. Ein Beispiel für einen UPN-Wert ist erika@contoso.onmicrosoft.com.
Sie verwenden diesen Parameter für Exchange- und Microsoft Teams-Workloads.
| Typ: | String |
| Position: | 6 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Security & Compliance |
-Workload
Der Workload-Parameter gibt den Speicherort an, aus dem Dateidetails exportiert werden sollen. Gültige Werte sind:
- EXO oder Exchange
- ODB oder OneDrive
- SPO oder SharePoint
- Teams
| Typ: | String |
| Position: | 7 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
| Gilt für:: | Security & Compliance |