Verwenden von Microsoft Purview-APIs für eDiscovery

Die Microsoft Purview-API (Application Programming Interface) für eDiscovery in Microsoft Graph ermöglicht es Ihrer organization, sich wiederholende Aufgaben zu automatisieren und in Ihre vorhandenen eDiscovery-Tools zu integrieren, um wiederholbare Workflows zu erstellen, die Branchenvorschriften möglicherweise erfordern. Dieser Artikel enthält Anleitungen zum Konfigurieren der erforderlichen Voraussetzungen, um den Zugriff auf die Microsoft Purview-APIs für eDiscovery zu ermöglichen. Diese Anleitung basiert auf dem reinen App-Zugriff auf die APIs, entweder mit einem geheimen Clientschlüssel oder einem selbstsignierten Zertifikat zur Authentifizierung der Anforderungen.

Microsoft Purview-APIs

Die Microsoft Purview-APIs für eDiscovery umfassen zwei separate APIs:

  • Microsoft Graph: Teil des Microsoft.Graph.Security Namespace und wird für die Arbeit mit eDiscovery-Fällen verwendet.
  • Microsoft Purview-eDiscovery-API: Wird ausschließlich zum programmgesteuerten Herunterladen von Paketen verwendet, die beim Exportieren aus Suchvorgängen und Prüfsätzen in eDiscovery erstellt wurden.

eDiscovery-APIs in Microsoft Graph unterstützen eDiscovery-Fälle mit und ohne aktivierte Premium-Features. Die delegierte Authentifizierung unterstützt wichtige eDiscovery-Funktionen wie Fälle, Halteräume, Suchen und Exporte. Die Nur-App-Authentifizierung ist für Fälle mit aktivierten Premium-Features verfügbar und unterstützt erweiterte Vorgänge wie Prüfdateisätze, Tagging und Analysen.

Eine Liste der unterstützten API-Aufrufe innerhalb der Microsoft Graph-Aufrufe finden Sie unter Verwenden der Microsoft Purview-eDiscovery-API.

Anwendungszugriff auf Daten

Bevor Sie die Microsoft Purview-APIs für eDiscovery aufrufen können, müssen Sie zuerst eine App in der Microsoft Identity Platform, Entra ID, registrieren.

Eine Anwendung kann auf zwei Arten auf Daten zugreifen:

  • Delegierter Zugriff: Eine App, die im Namen eines angemeldeten Benutzers handelt.
  • Nur-App-Zugriff: Eine App, die mit einer eigenen Identität agiert.

Weitere Informationen zu Zugriffsszenarien finden Sie unter Grundlagen der Authentifizierung und Autorisierung.

Wichtig

Nur-App-Authentifizierung erfordert einen eDiscovery-Fall mit aktivierten Premium-Features. Die delegierte Authentifizierung ist für wichtige eDiscovery-Funktionen verfügbar, darunter Fälle, gesetzliche Aufbewahrungspflichten, Suchvorgänge und Exporte. Premium-API-Vorgänge (Prüfdateisätze, Tagging, Analyse) erfordern unabhängig von der Authentifizierungsmethode die Aktivierung von Premium-Features. Weitere Informationen zu den Abonnementanforderungen finden Sie unter Abonnementanforderungen für eDiscovery.

Microsoft Graph-API

Voraussetzungen für die Microsoft Graph-API

Das Implementieren des Nur-App-Zugriffs umfasst das Registrieren einer App im Azure-Portal, das Erstellen von geheimen Clientschlüsseln/Zertifikaten, das Zuweisen von API-Berechtigungen, das Einrichten eines Dienstprinzipals und das anschließende Verwenden des Nur-App-Zugriffs zum Aufrufen von Microsoft Graph-APIs. Um eine App zu registrieren, geheime Clientschlüssel oder Zertifikate zu erstellen und API-Berechtigungen zuzuweisen, muss das Konto ein Cloudanwendungsadministrator sein.

Weitere Informationen zum Registrieren einer App im Azure-Portal finden Sie unter Registrieren einer Anwendung bei der Microsoft Identity Platform.

Zum Erteilen der mandantenweiten Administratorzustimmung für Microsoft Purview-eDiscovery-API-Anwendungsberechtigungen müssen Sie sich als Benutzer anmelden, der zur Zustimmung im Namen Ihrer organization berechtigt ist. Weitere Informationen finden Sie unter Erteilen der mandantenweiten Administratorzustimmung für eine Anwendung.

Für die Einrichtung eines Dienstprinzipals sind die folgenden Voraussetzungen erforderlich:

Ausführliche Schritte zum Implementieren des Nur-App-Zugriffs für eDiscovery finden Sie unter Einrichten des Nur-App-Zugriffs für Microsoft Purview-eDiscovery.

Herstellen einer Verbindung mit der Microsoft Graph-API mit Nur-App-Zugriff

Verwenden Sie das Cmdlet Connect-MgGraph in PowerShell zum Authentifizieren und Herstellen einer Verbindung mit Microsoft Graph mithilfe der Nur-App-Zugriffsmethode. Mit diesem Cmdlet können Ihre App sicher mit Microsoft Graph interagieren und die Microsoft Purview-eDiscovery-APIs erkunden.

Herstellen einer Verbindung über geheimen Clientschlüssel

Um eine Verbindung mit einem geheimen Clientschlüssel herzustellen, aktualisieren Sie den folgenden PowerShell-Beispielcode, und führen Sie ihn aus.

$clientSecret = "<client secret>" ## Update with client secret added to the registered app
$appID = "<APP ID>" ## Update with Application ID of registered/Enterprise app
$tenantId = "<Tenant ID>" ## Update with tenant ID
$ClientSecretPW = ConvertTo-SecureString "$clientSecret" -AsPlainText -Force
$clientSecretCred = New-Object System.Management.Automation.PSCredential -ArgumentList ("$appID", $clientSecretPW)
Connect-MgGraph -TenantId "$tenantId" -ClientSecretCredential $clientSecretCred

Verbindung über Zertifikat herstellen

Um eine Verbindung mithilfe eines Zertifikats herzustellen, aktualisieren Sie den folgenden PowerShell-Beispielcode, und führen Sie ihn aus.

$certPath = "Cert:\currentuser\my\<xxxxxxxxxx>" ## Update with the cert thumbnail
$appID = "<APP ID>" ## Update with Application ID of registered/Enterprise app
$tenantId = "<Tenant ID>" ## Update with tenant ID
$ClientCert = Get-ChildItem $certPath
Connect-MgGraph -TenantId $TenantId -ClientId $appId -Certificate $ClientCert

Microsoft Graph-API-Aufrufe aufrufen

Nachdem Sie eine Verbindung hergestellt haben, können Sie die Microsoft Graph-API aufrufen.

Beispielsweise können Sie die eDiscovery-Fälle innerhalb des Mandanten mithilfe der ediscoveryCases-API auflisten. Die Anleitung für jeden Vorgang listet die folgenden Informationen auf:

  • Erforderliche Berechtigungen für den API-Aufruf
  • HTTP-Anforderung und -Methode
  • Informationen zu Anforderungsheader und -text
  • Antwort
  • Beispiele (HTTP, C#, CLI, Go, Java, PHP, PowerShell, Python)

Da Sie über das Microsoft Graph PowerShell-Modul verbunden sind, können Sie entweder die HTTP- oder die PowerShell-Methode verwenden.

Sehen wir uns zunächst das PowerShell-Beispiel an.

PowerShell-Beispiel für die Liste der eDiscovery-Fälle.

Wie Sie sehen können, wird eine Liste aller Fälle innerhalb des Mandanten zurückgegeben. Wenn Sie tiefer in einen Fall eintauchen, ist es wichtig, die Fall-ID aufzuzeichnen. Sie benötigen diese ID für zukünftige API-Aufrufe.

Sehen wir uns nun ein HTTP-Beispiel an. Sie verwenden das Cmdlet Invoke-MgGraphRequest, um den Aufruf mithilfe von PowerShell durchzuführen.

Speichern Sie zunächst die URL in einer Variablen:

$uri = "https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases"

Verwenden Sie dann das Cmdlet Invoke-MgGraphRequest, um den API-Aufruf durchzuführen.

Invoke-MgGraphRequest -Method Get -Uri $uri

Wie Sie der folgenden Ausgabe entnehmen können, müssen Sie die Werte aus der zurückgegebenen Antwort extrahieren.

PowerShell-Beispiel für URL-Ausgabe.

Sie können die Value-Elemente der Antwort mit dem folgenden Befehl in einer neuen Variablen speichern.

$cases = (Invoke-MgGraphRequest -Method Get -Uri $uri).value

PowerShell-Beispiel zum Extrahieren einer URL.

PowerShell-Beispiel zum Extrahieren der URL für Fälle.

Dieser Befehl gibt eine Auflistung von Hashtabellen zurück. Optional können Sie ein wenig PowerShell-Code ausführen, um die Hashtabellen in PowerShell-Objekte zu konvertieren und so die Verwendung mit Cmdlet-Parametern wie format-table und format-list zu vereinfachen.

$CasesAsObjects = @()
foreach($i in $cases) {$CasesAsObjects += [pscustomobject]$i}
$CasesAsObjects | ft displayname,id,status

PowerShell-Beispiel zum Konvertieren von Hashtabellen.

Microsoft Purview-eDiscovery-API

Sie können die Microsoft Purview-eDiscovery-API so konfigurieren, dass in einem eDiscovery-Fall das programmgesteuerte Herunterladen von Exportpaketen und Berichten aus einem Exportprozess ermöglicht wird.

Wichtig

Die App-basierte Authentifizierung für eDiscovery-Exportdownloads über Microsoft Graph wird in Government Community Cloud (GCC) derzeit nicht unterstützt. Diese Einschränkung gilt speziell für Exportdownloads und ist keine allgemeine Einschränkung für die App-basierte Authentifizierung für eDiscovery-APIs.

Voraussetzungen für die Microsoft Purview-eDiscovery-API

Bevor Sie die Konfigurationsschritte in diesem Abschnitt ausführen, vervollständigen und validieren Sie die im Abschnitt Microsoft Graph-API beschriebene Konfiguration. Erweitern Sie die zuvor registrierte App in Microsoft Entra ID um die erforderlichen Berechtigungen, um einen programmgesteuerten Download des Exportpakets zu ermöglichen.

Diese Konfiguration bietet bereits die folgenden Voraussetzungen:

  • Registrierte App im Azure-Portal, konfiguriert mit dem entsprechenden geheimen Clientschlüssel oder Zertifikat.
  • Dienstprinzipal in Microsoft Purview hat die entsprechenden eDiscovery-Rollen zugewiesen.
  • Für Microsoft Graph konfigurierte Microsoft eDiscovery-API-Berechtigungen.

Führen Sie die folgenden Schritte aus, um die API-Berechtigungen der vorhandenen registrierten App zu erweitern, um den programmgesteuerten Download zu ermöglichen:

  • Registrieren Sie einen neuen Microsoft-Anwendungs- und Dienstprinzipal im Mandanten.
  • Weisen Sie der zuvor registrierten App im Azure-Portal zusätzliche API-Berechtigungen zu.

Um mandantenweite Administratorzustimmung für Anwendungsberechtigungen für Microsoft Purview-eDiscovery-APIs zu erteilen, melden Sie sich als Benutzer an, der berechtigt ist, im Namen der organization zuzustimmen. Weitere Informationen finden Sie unter Erteilen der mandantenweiten Administratorzustimmung für eine Anwendung.

Konfigurationsschritte

Schritt 1: Registrieren der MicrosoftPurviewEDiscovery-App in Microsoft Entra ID

Führen Sie die folgenden Schritte aus:

  1. Überprüfen Sie, ob die MicrosoftPurviewEDiscovery-App noch nicht registriert ist. Melden Sie sich beim Azure-Portal an, und wechseln Sie zu Microsoft EntraID-Unternehmensanwendungen>.

  2. Ändern Sie den Anwendungstypfilter , um Microsoft-Anwendungen anzuzeigen.

  3. Geben Sie im Suchfeld "MicrosoftPurviewEDiscovery" ein. Die MicrosoftPurviewEDiscovery-App sollte angezeigt werden. Wenn die MicrosoftPurviewEDiscovery-App nicht aufgeführt ist, registrieren Sie die App in Microsoft Entra ID.

    Führen Sie die folgenden Schritte aus, um die App zu registrieren:

    • Verwenden Sie das Microsoft.Graph PowerShell-Modul, um die MicrosoftPurviewEDiscovery-App in Microsoft Entra ID zu registrieren. Weitere Informationen finden Sie unter Installieren des Microsoft Graph PowerShell SDK.
    • Nachdem das Modul auf einem Computer installiert wurde, führen Sie das folgende Cmdlet aus, um mithilfe von PowerShell eine Verbindung mit Microsoft Graph herzustellen:
    Connect-MgGraph -scopes "Application.ReadWrite.All"
    

    Wenn Sie zum ersten Mal Microsoft Graph PowerShell-Cmdlets verwenden, werden Sie möglicherweise aufgefordert, den erforderlichen Berechtigungen zuzustimmen.

    Führen Sie zum Registrieren der MicrosoftPurviewEDiscovery-App die folgenden PowerShell-Befehle aus. Ersetzen Sie <MicrosoftPurviewEDiscovery application ID> diese durch die Anwendungs-ID der MicrosoftPurviewEDiscovery-App, nicht die Anwendungs-ID (Client-ID) Ihrer eigenen registrierten App. Verwenden Sie dieselbe MicrosoftPurviewEDiscovery-Anwendungs-ID im Export-Token-Bereich in den Beispielskripts zum Herunterladen.

    $spId = @{"AppId" = "<MicrosoftPurviewEDiscovery application ID>" }
    
    New-MgServicePrincipal -BodyParameter $spId;
    

Hinweis

Verwenden Sie das PowerShell-Skript, um eine neue Anwendung in Microsoft Entra ID zu registrieren und ggf. die Microsoft Purview-eDiscovery-API-Berechtigungen für die Anwendungsauthentifizierung zuzuweisen. Nachdem Sie die Anwendung registriert haben, müssen Sie den geheimen Clientschlüssel oder das Zertifikat konfigurieren und die Administratorzustimmung über das Portal erteilen.

Schritt 2: Zuweisen zusätzlicher MicrosoftPurviewEDiscovery-Berechtigungen zur registrierten App

Nachdem der Dienstprinzipal hinzugefügt wurde, aktualisieren Sie die Berechtigungen für Ihre zuvor registrierte App, die im Abschnitt zur Microsoft Graph-API dieses Artikels erstellt wurde. Melden Sie sich beim Azure-Portal an, und wechseln Sie zu Microsoft Entra ID App-Registrierungen>.

  1. Suchen Sie die App, die Sie erstellt haben, im Abschnitt "Microsoft Graph-API" dieses Artikels, und wählen Sie sie aus.
  2. Wählen Sie API-Berechtigungen im Navigationsmenü aus.
  3. Wählen Sie Berechtigung hinzufügen und dann APIs aus, die meine organization verwendet.
  4. Suchen Sie nach MicrosoftPurviewEDiscovery und wählen Sie es aus.
  5. Wählen Sie Anwendungsberechtigungen aus.
  6. Aktivieren Sie das Kontrollkästchen für eDiscovery.Download.Read.
  7. Wählen Sie Berechtigungen hinzufügen aus.
  8. Wählen Sie unter API-Berechtigungendie Option Admin-Zustimmung erteilen (Ihre organization) aus, um die hinzugefügten Berechtigungen zu genehmigen.

Nachdem die Zustimmung des Administrators erteilt wurde, wird der Status der hinzugefügten Berechtigungen für Ihre organization aktualisiert.

Herunterladen der Exportpakete und Berichte

Abrufen der Fall-ID und Exportauftrags-ID

Um die Exportpakete und Berichte eines Exportprozesses in einem eDiscovery-Fall herunterzuladen, benötigen Sie die Fall-ID und die Vorgangs- oder Auftrags-ID für den Exportauftrag.

So sammeln Sie diese Informationen mithilfe des Microsoft Purview-Portals:

  • Öffnen Sie einen eDiscovery-Fall.
  • Suchen Sie den Exportvorgang.
  • Wählen Sie "Supportinformationen kopieren" aus.
  • Fügen Sie diese Informationen in einen Texteditor (z. B. Editor) ein.

Alternativ können Sie programmgesteuert auf diese Informationen zugreifen, indem Sie die folgenden Graph-API-Aufrufe verwenden, um die Fall-ID und die Auftrags-ID zu suchen, die Sie exportieren möchten:

  1. Stellen Sie eine Verbindung mit Microsoft Graph her, indem Sie die Schritte im Abschnitt Herstellen einer Verbindung mit der Microsoft Graph-API mit Nur-App-Zugriff in diesem Artikel ausführen.

  2. Verwenden Sie die eDiscovery Graph PowerShell-Cmdlets mit dem folgenden Befehl, wenn Sie den Namen der Groß-/Kleinschreibung kennen:

    Get-MgSecurityCaseEdiscoveryCase | where {$_.displayname -eq "<Name of case>"}
    
  3. Nachdem Sie die Fall-ID haben, suchen Sie die Vorgänge in dem Fall, um die Auftrags-ID für den Export mit dem folgenden Befehl zu identifizieren:

    Get-MgSecurityCaseEdiscoveryCaseOperation -EdiscoveryCaseId "<case ID>"
    

Exportaufträge werden unter der Aktion exportResult für einen direkten Export aus der Suche oder ContentExport für einen Export aus einem Prüfdateisatz protokolliert. Der Name der Exportaufträge wird von diesem API-Aufruf nicht zurückgegeben. Um den Namen des Exportprozesses zu finden, müssen Sie die spezifische Vorgangs-ID abfragen. Verwenden Sie den folgenden Befehl, um den Namen des Exportprozesses zu ermitteln:

Get-MgSecurityCaseEdiscoveryCaseOperation -EdiscoveryCaseId "<case ID>" -CaseOperationId “<operation ID>”

Der Name des Exportvorgangs ist im Feld AdditionalProperties enthalten.

Informationen zum direkten Ausführen der HTTP-API-Aufrufe zum Auflisten von Fällen in Ihrer organization finden Sie unter Auflisten von ediscoveryCases.

Informationen zum direkten Ausführen der HTTP-API-Aufrufe zum Auflisten der Vorgänge für einen Fall finden Sie unter Auflisten von caseOperations.

Verwenden Sie die Fall-ID im API-Aufruf, um anzugeben, aus welchem Fall die Vorgänge aufgelistet werden sollen. Beispiel:

https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/<CaseID>/operations/

Der Name der Exportaufträge wird mit diesem API-Aufruf nicht zurückgegeben. Um den Namen des Exportprozesses zu finden, müssen Sie die spezifische Auftrags-ID abfragen. Beispiel:

https://graph.microsoft.com/v1.0/security/cases/ediscoveryCases/<CaseID>/operations/<OperationID>

Herunterladen eines Exportpakets

Abrufen der Download-URLs für Exportpakete

Die exportFileMetaData-Eigenschaft enthält die URL, die Sie zum Herunterladen der Exportpakete und Berichte benötigen. Zum Abrufen der URL benötigen Sie die Fall-ID des eDiscovery-Falls, auf dem Sie den Exportprozess ausgeführt haben, und die Vorgangs-ID für den Exportprozess.

Verwenden Sie die folgenden eDiscovery Graph PowerShell-Cmdlets, um diese Informationen zu finden:

$operation = Get-MgSecurityCaseEdiscoveryCaseOperation -EdiscoveryCaseId "<case ID>" -CaseOperationId “<operation ID>”
$Operation.AdditionalProperties.exportFileMetadata

Informationen zu direkten HTTP-API-Aufrufen, um die exportFileMetaData-Informationen für eine Operation zurückzugeben, finden Sie unter Auflisten von caseOperations.

Jedes Exportpaket im Microsoft Purview-Portal verfügt über einen Eintrag in der exportFileMetaData-Eigenschaft . In jedem Eintrag werden die folgenden Informationen aufgelistet:

  • Dateiname des Exportpakets
  • Die downloadUrl zum Abrufen des Exportpakets
  • Die Größe des Exportpakets

Beispielskripts zum Herunterladen des Exportpakets

Da die Microsoft Purview-eDiscovery-API von der Microsoft Graph-API getrennt ist, benötigen Sie ein separates Authentifizierungstoken, um eine Downloadanforderung zu autorisieren. Verwenden Sie das MSAL.PS PowerShell-Modul und das Cmdlet Get-MSALToken, um ein separates Token abzurufen. Sie müssen auch eine Verbindung zu den Microsoft Graph-APIs herstellen, indem Sie das Cmdlet Connect-MgGraph verwenden.

Die folgenden Beispielskripts können als Referenz verwendet werden, wenn Sie eigene Skripts entwickeln, um den programmgesteuerten Download der Exportpakete zu ermöglichen.

Verwenden Sie die folgenden Werte für die Authentifizierungsparameter in beiden Skripts:

Parameter oder Platzhalter Wert
tenantId Die Verzeichnis-ID (Mandant) Ihres Microsoft Entra-Mandanten.
appId Die Anwendungs-ID (Client-ID) Ihrer eigenen registrierten App, die mit den in Schritt 2 beschriebenen Berechtigungen konfiguriert wurde. Dieser Wert wird sowohl für die Microsoft Graph- als auch für die Export-Token-Authentifizierung übergeben ClientId .
appSecret oder certPath Der Wert des geheimen Clientschlüssels oder der Zertifikatspeicherpfad für Ihre eigene registrierte App.
<MicrosoftPurviewEDiscovery application ID> Die Anwendungs-ID der MicrosoftPurviewEDiscovery-Microsoft-Anwendung , die in Schritt 1 registriert wurde. Suchen Sie diesen Wert in Microsoft EntraIDEnterprise-Anwendungen>>MicrosoftPurviewEDiscovery>Übersicht>Anwendungs-ID. Verwenden Sie weder die Objekt-ID noch die Anwendungs-ID (Client-ID) Ihrer eigenen App.

Ersetzen Sie <MicrosoftPurviewEDiscovery application ID> in jedem Skript den Export-Token-Bereich, und behalten Sie das /.default Suffix bei. Dieser Bereich identifiziert die Microsoft Purview-eDiscovery-API, die das Token empfängt. Im Zertifikatbeispiel verwendet der Scope Eintrag in $connectionDetails diesen Wert, bleibt ClientId aber die ID Ihrer eigenen registrierten App.

Herstellen einer Verbindung mit einem geheimen Clientschlüssel

Wenn Sie Ihre App für die Verwendung eines geheimen Clientschlüssels konfiguriert haben, verwenden Sie das folgende Beispielskript als Referenz, um das Exportpaket und die Berichte programmgesteuert herunterzuladen. Kopieren Sie den Inhalt in den Editor, und speichern Sie ihn unter DownloadExportUsingApp.ps1.

[CmdletBinding()]
param (
    [Parameter(Mandatory = $true)]
    [string]$tenantId,
    [Parameter(Mandatory = $true)]
    [string]$appId,
    [Parameter(Mandatory = $true)]
    [string]$appSecret,
    [Parameter(Mandatory = $true)]
    [string]$caseId,
    [Parameter(Mandatory = $true)]
    [string]$exportId,
    [Parameter(Mandatory = $true)]
    [string]$path = "D:\Temp",
    [ValidateSet($null, 'USGov', 'USGovDoD')]
    [string]$environment = $null
)

if (-not(Get-Module -Name Microsoft.Graph -ListAvailable)) {
    Write-Host "Installing Microsoft.Graph module"
    Install-Module Microsoft.Graph -Scope CurrentUser
}

if (-not(Get-Module -Name MSAL.PS -ListAvailable)) {
    Write-Host "Installing MSAL.PS module"
    Install-Module MSAL.PS -Scope CurrentUser
}

$password = ConvertTo-SecureString $appSecret -AsPlainText -Force
$clientSecretCred = New-Object System.Management.Automation.PSCredential -ArgumentList ($appId, $password)

if (-not(Get-MgContext)) {
    Write-Host "Connect with credentials of a ediscovery admin (token for graph)"
    if (-not($environment)) {
        Connect-MgGraph -TenantId $TenantId -ClientSecretCredential $clientSecretCred
    }
    else {
        Connect-MgGraph -TenantId $TenantId -ClientSecretCredential $clientSecretCred -Environment $environment
    }
}

Write-Host "Connect with credentials of a ediscovery admin (token for export)"
$exportToken = Get-MsalToken -ClientId $appId -Scopes "<MicrosoftPurviewEDiscovery application ID>/.default" -TenantId $tenantId -RedirectUri "http://localhost" -ClientSecret $password

$uri = "/v1.0/security/cases/ediscoveryCases/$($caseId)/operations/$($exportId)"

$export = Invoke-MgGraphRequest -Uri $uri;
if (-not($export)){
    Write-Host "Export not found"
    exit
}
else{
    $export.exportFileMetadata | % {
        Write-Host "Downloading $($_.fileName)"
        Invoke-WebRequest -Uri $_.downloadUrl -OutFile "$($path)\$($_.fileName)" -Headers @{"Authorization" = "Bearer $($exportToken.AccessToken)"; "X-AllowWithAADToken" = "true" }
    }
}

Speichern Sie das Skript, und öffnen Sie ein neues PowerShell-Fenster, in dem die folgenden PowerShell-Module installiert sind:

  • Microsoft.Graph
  • MSAL.PS

Navigieren Sie zu dem Verzeichnis, in dem Sie das Skript gespeichert haben, und führen Sie den folgenden Befehl aus:

.\DownloadExportUsingApp.ps1 -tenantId “<tenant ID>” -appId “<App ID>” -appSecret “<Client Secret>” -caseId “<CaseID>” -exportId “<ExportID>” -path “<Output Path>”

Überprüfen Sie den Ordner, den Sie als Pfad zum Anzeigen der heruntergeladenen Dateien angegeben haben.

Herstellen einer Verbindung mit einem Zertifikat

Wenn Sie Ihre App für die Verwendung eines Zertifikats konfiguriert haben, verwenden Sie das folgende Beispielskript als Referenz, um das Exportpaket und die Berichte programmgesteuert herunterzuladen. Kopieren Sie den Inhalt in einen Text-Editor, und speichern Sie ihn als DownloadExportUsingAppCert.ps1

[CmdletBinding()]
param (
    [Parameter(Mandatory = $true)]
    [string]$tenantId,
    [Parameter(Mandatory = $true)]
    [string]$appId,
    [Parameter(Mandatory = $true)]
    [String]$certPath,
    [Parameter(Mandatory = $true)]
    [string]$caseId,
    [Parameter(Mandatory = $true)]
    [string]$exportId,
    [Parameter(Mandatory = $true)]
    [string]$path = "D:\Temp",
    [ValidateSet($null, 'USGov', 'USGovDoD')]
    [string]$environment = $null
)

if (-not(Get-Module -Name Microsoft.Graph -ListAvailable)) {
    Write-Host "Installing Microsoft.Graph module"
    Install-Module Microsoft.Graph -Scope CurrentUser
}

if (-not(Get-Module -Name MSAL.PS -ListAvailable)) {
    Write-Host "Installing MSAL.PS module"
    Install-Module MSAL.PS -Scope CurrentUser
}

##$password = ConvertTo-SecureString $appSecret -AsPlainText -Force
##$clientSecretCred = New-Object System.Management.Automation.PSCredential -ArgumentList ($appId, $password)

$ClientCert = Get-ChildItem $certPath

if (-not(Get-MgContext)) {
    Write-Host "Connect with credentials of a ediscovery admin (token for graph)"
    if (-not($environment)) {
        Connect-MgGraph -TenantId $TenantId -ClientId $appId -Certificate $ClientCert
    }
    else {
        Connect-MgGraph -TenantId $TenantId -ClientId $appId -Certificate $ClientCert -Environment $environment
    }
}

Write-Host "Connect with credentials of a ediscovery admin (token for export)"

$connectionDetails = @{
    'TenantId'          = $tenantId
    'ClientId'          = $appID
    'ClientCertificate' = $ClientCert
    'Scope' = "<MicrosoftPurviewEDiscovery application ID>/.default"
}

$exportToken = Get-MsalToken @connectionDetails

$uri = "/v1.0/security/cases/ediscoveryCases/$($caseId)/operations/$($exportId)"

$export = Invoke-MgGraphRequest -Uri $uri;
if (-not($export)){
    Write-Host "Export not found"
    exit
}
else{
    $export.exportFileMetadata | % {
        Write-Host "Downloading $($_.fileName)"
        Invoke-WebRequest -Uri $_.downloadUrl -OutFile "$($path)\$($_.fileName)" -Headers @{"Authorization" = "Bearer $($exportToken.AccessToken)"; "X-AllowWithAADToken" = "true" }
    }
}

Wenn Sie das Skript speichern, öffnen Sie ein neues PowerShell-Fenster, in dem die folgenden PowerShell-Module installiert sind:

  • Microsoft.Graph
  • MSAL.PS

Navigieren Sie zu dem Verzeichnis, in dem Sie das Skript gespeichert haben, und führen Sie den folgenden Befehl aus.

.\DownloadExportUsingAppCert.ps1 -tenantId “<tenant ID>” -appId “<App ID>” -certPath “<Certificate Path>” -caseId “<CaseID>” -exportId “<ExportID>” -path “<Output Path>”

Überprüfen Sie den Ordner, den Sie als Pfad zum Anzeigen der heruntergeladenen Dateien angegeben haben.