New-ComplianceSearchAction
Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen können für die eine oder die andere Umgebung exklusiv sein.
Verwenden Sie das Cmdlet New-ComplianceSearchAction, um Aktionen für Inhaltssuchen in Exchange Server und im Microsoft Purview-Complianceportal zu erstellen.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
Export
New-ComplianceSearchAction
[-SearchName] <String[]>
[-Export]
[-ActionName <String>]
[-ArchiveFormat <ComplianceExportArchiveFormat>]
[-Confirm]
[-FileTypeExclusionsForUnindexedItems <String[]>]
[-EnableDedupe <Boolean>]
[-ExchangeArchiveFormat <ComplianceExportArchiveFormat>]
[-Force]
[-Format <ComplianceDataTransferFormat>]
[-IncludeCredential]
[-IncludeSharePointDocumentVersions <Boolean>]
[-JobOptions <Int32>]
[-NotifyEmail <String>]
[-NotifyEmailCC <String>]
[-ReferenceActionName <String>]
[-Region <String>]
[-Report]
[-RetentionReport]
[-RetryOnError]
[-Scenario <ComplianceSearchActionScenario>]
[-Scope <ComplianceExportScope>]
[-SearchNames <String[]>]
[-SharePointArchiveFormat <ComplianceExportArchiveFormat>]
[-ShareRootPath <String>]
[-Version <String>]
[-WhatIf]
[<CommonParameters>]
Preview
New-ComplianceSearchAction
[-SearchName] <String[]>
[-Preview]
[-ActionName <String>]
[-Confirm]
[-Force]
[-Format <ComplianceDataTransferFormat>]
[-IncludeCredential]
[-JobOptions <Int32>]
[-ReferenceActionName <String>]
[-Region <String>]
[-RetryOnError]
[-Scenario <ComplianceSearchActionScenario>]
[-SearchNames <String[]>]
[-Version <String>]
[-WhatIf]
[<CommonParameters>]
Purge
New-ComplianceSearchAction
[-SearchName] <String[]>
[-Purge]
[-PurgeType <ComplianceDestroyType>]
[-ActionName <String>]
[-Confirm]
[-Force]
[-Format <ComplianceDataTransferFormat>]
[-IncludeCredential]
[-JobOptions <Int32>]
[-Region <String>]
[-ReferenceActionName <String>]
[-RetryOnError]
[-Scenario <ComplianceSearchActionScenario>]
[-SearchNames <String[]>]
[-Version <String>]
[-WhatIf]
[<CommonParameters>]
Beschreibung
Nachdem Sie eine Inhaltssuche mit dem Cmdlet New-ComplianceSearch erstellt und mit dem Cmdlet Start-ComplianceSearch ausgeführt haben, weisen Sie der Suche mithilfe des Cmdlets New-ComplianceSearchAction eine Suchaktion zu.
In lokalem Exchange ist dieses Cmdlet in der Postfachsuche-Rolle verfügbar. Standardmäßig wird diese Rolle nur der Rollengruppe Ermittlungsverwaltung zugewiesen.
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
In Microsoft 365 muss dem Konto, das Sie zum Ausführen dieses Cmdlets verwenden, eine gültige Microsoft 365-Lizenz zugewiesen sein.
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.
Um dieses Cmdlet für Bereinigungsaktionen in Security & Compliance PowerShell verwenden zu können, müssen Sie die folgenden Anforderungen erfüllen:
- Verwenden Sie die Exchange Online PowerShell-Version 3.9.0 oder höher (August 2025). Weitere Informationen finden Sie unter Neuerungen im Exchange Online PowerShell-Modul. Wenn Sie diese Version des Moduls installieren, müssen Sie möglicherweise alle vorherigen Versionen des Moduls nicht verwenden.
- Führen Sie den Befehl Connect-IPPSSession mit dem Schalter EnableSearchOnlySession aus.
Beispiele
Beispiel 1
New-ComplianceSearchAction -SearchName "Project X" -Preview
In diesem Beispiel wird eine Vorschausuchaktion für die Inhaltssuche mit dem Namen Project X erstellt.
Beispiel 2
New-ComplianceSearchAction -SearchName "Project X" -Export
In diesem Beispiel wird eine Exportsuchaktion für die Inhaltssuche mit dem Namen Project X erstellt.
Hinweis: Nach dem 26. Mai 2025 funktioniert dieses Beispiel nicht mehr. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
Beispiel 3
New-ComplianceSearchAction -SearchName "Remove Phishing Message" -Purge -PurgeType SoftDelete
In diesem Beispiel werden die Suchergebnisse gelöscht, die von einer Inhaltssuche mit dem Namen Remove Phishing Message (Phishingnachricht entfernen) zurückgegeben werden. Nicht indizierte Elemente werden nicht gelöscht, wenn Sie den Purge-Parameter verwenden.
Beispiel 4
New-ComplianceSearchAction -SearchName "Case 321 All Sites" -Export -SharePointArchiveFormat SingleZip -ExchangeArchiveFormat PerUserPst -Format FxStream
In diesem Beispiel werden die Ergebnisse exportiert, die von der Inhaltssuche mit dem Namen "Case 321 All Sites" zurückgegeben werden. Die Suchergebnisse werden komprimiert und in eine einzelne ZIP-Datei exportiert. Wenn die Suche Exchange-Speicherorte enthält, werden die Suchergebnisse als eine PST-Datei pro Postfach exportiert.
Hinweis: Nach dem 26. Mai 2025 funktioniert dieses Beispiel nicht mehr. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
Parameter
-ActionName
Anwendbar: Security & Compliance
Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.
Der Parameter ActionName gibt einen Namen für die Inhaltssuchaktion an. Sie verwenden diesen Parameter nur, wenn Sie mehrere Inhaltssuchen im SearchName-Parameter angeben.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ArchiveFormat
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Dieser Parameter ist veraltet und wird nicht mehr verwendet.
Verwenden Sie den Parameter ExchangeArchiveFormat, um das Format für Exchange-Suchergebnisse anzugeben. Um das Format für SharePoint- und OneDrive-Suchergebnisse anzugeben, verwenden Sie den Parameter SharePointArchiveFormat.
Parametereigenschaften
| Typ: | ComplianceExportArchiveFormat |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Confirm
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.
- Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Dieses Cmdlet verfügt über eine integrierte Pause. Verwenden Sie -Confirm:$false daher , um die Bestätigung zu überspringen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-EnableDedupe
Anwendbar: Security & Compliance
Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ExchangeArchiveFormat
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Hinweis: Nach dem 26. Mai 2025 ist dieser Parameter nicht mehr funktionsfähig. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Für diesen Parameter ist die Exportrolle in Security & Compliance PowerShell erforderlich. Standardmäßig wird diese Rolle nur der Rollengruppe eDiscovery-Manager zugewiesen.
Der Parameter ExchangeArchiveFormat gibt an, wie Exchange-Suchergebnisse exportiert werden. Gültige Werte sind:
- PerUserPst: Eine PST-Datei für jedes Postfach.
- SinglePst: Eine PST-Datei, die alle exportierten Nachrichten enthält.
- SingleFolderPst: Eine PST-Datei mit einem einzigen Stammordner für den gesamten Export.
- IndividualMessage: Exportieren Sie jede Nachricht als .msg Nachrichtendatei. Dieser Wert ist die Standardeinstellung.
- PerUserZip: Eine ZIP-Datei für jedes Postfach. Jede ZIP-Datei enthält die exportierten .msg Nachrichtendateien aus dem Postfach.
- SingleZip: Eine ZIP-Datei für alle Postfächer. Die ZIP-Datei enthält alle exportierten .msg Nachrichtendateien aus allen Postfächern. Diese Ausgabeeinstellung ist nur in PowerShell verfügbar.
Um das Format für SharePoint- und OneDrive-Suchergebnisse anzugeben, verwenden Sie den Parameter SharePointArchiveFormat.
Parametereigenschaften
| Typ: | ComplianceExportArchiveFormat |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Export
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Hinweis: Nach dem 26. Mai 2025 ist dieser Parameter nicht mehr funktionsfähig. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Für diesen Parameter ist die Exportrolle in Security & Compliance PowerShell erforderlich. Standardmäßig wird diese Rolle nur der Rollengruppe eDiscovery-Manager zugewiesen.
Der Schalter Exportieren gibt an, dass die Aktion für die Inhaltssuche darin besteht, den vollständigen Satz von Ergebnissen zu exportieren, die den Suchkriterien entsprechen. Sie müssen keinen Wert für diese Option angeben.
Verwenden Sie die Option Report, um nur die Informationen zu jedem ermittelten Element in einem Bericht zurückzugeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-FileTypeExclusionsForUnindexedItems
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Hinweis: Nach dem 26. Mai 2025 ist dieser Parameter nicht mehr funktionsfähig. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
FileTypeExclusionsForUnindexedItems gibt die auszuschließenden Dateitypen an, da sie nicht indiziert werden können. Es können mehrere Werte durch Kommata getrennt angegeben werden.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Force
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.
Sie können diesen Switch verwenden, um Aufgaben in Fällen programmgesteuert auszuführen, in denen die administrative Eingabe unangemessen ist.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Format
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
In Security & Compliance PowerShell ist für diesen Parameter die Exportrolle erforderlich. Standardmäßig wird diese Rolle nur der Rollengruppe eDiscovery-Manager zugewiesen.
Der Parameter Format gibt das Format der Suchergebnisse an, wenn Sie die Option Export verwenden. Gültige Werte sind:
- FxStream: Exportieren in PST-Dateien. Dies ist die einzige Option, die verfügbar ist, wenn Sie Suchergebnisse aus dem Microsoft Purview-Complianceportal exportieren.
- Mime: In .eml Nachrichtendateien exportieren. Dies ist der Standardwert, wenn Sie Cmdlets verwenden, um die Suchergebnisse zu exportieren.
- Msg: Exportieren in .msg Nachrichtendateien.
Parametereigenschaften
| Typ: | ComplianceDataTransferFormat |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IncludeCredential
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Die Option IncludeCredential gibt an, ob die Anmeldeinformationen in die Ergebnisse eingeschlossen werden sollen. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IncludeSharePointDocumentVersions
Anwendbar: Security & Compliance
Hinweis: Nach dem 26. Mai 2025 ist dieser Parameter nicht mehr funktionsfähig. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.
Der Parameter IncludeSharePointDocumentVersions gibt an, ob frühere Versionen des Dokuments exportiert werden sollen, wenn Sie die Option Export verwenden. Gültige Werte sind:
- $true: Exportieren aller Versionen des Dokuments.
- $false: Exportieren Sie nur die aktuelle veröffentlichte Version des Dokuments. Dieser Wert ist die Standardeinstellung.
Parametereigenschaften
| Typ: | Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-JobOptions
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-NotifyEmail
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Hinweis: Nach dem 26. Mai 2025 ist dieser Parameter nicht mehr funktionsfähig. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
In Security & Compliance PowerShell ist für diesen Parameter die Exportrolle erforderlich. Standardmäßig wird dies nur der Rollengruppe eDiscovery-Manager zugewiesen.
Der Parameter NotifyEmail gibt das E-Mail-Adressziel für die Suchergebnisse an, wenn Sie die Option Export verwenden.
Der Empfänger, den Sie angeben, befindet sich im To:-Feld der Nachricht.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-NotifyEmailCC
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Hinweis: Nach dem 26. Mai 2025 ist dieser Parameter nicht mehr funktionsfähig. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
In Security & Compliance PowerShell ist für diesen Parameter die Exportrolle erforderlich. Standardmäßig wird diese Rolle nur der Rollengruppe eDiscovery-Manager zugewiesen.
Der Parameter NotifyEmailCC gibt das E-Mail-Adressziel für die Suchergebnisse an, wenn Sie die Option Export verwenden.
Der Empfänger, den Sie angeben, befindet sich im Cc:-Feld der Nachricht.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Preview
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
In Security & Compliance PowerShell erfordert dieser Parameter die Vorschaurolle. Standardmäßig wird diese Rolle nur der Rollengruppe eDiscovery-Manager zugewiesen.
Die Option Vorschau gibt die Aktion für die Inhaltssuche an, um eine Vorschau der Ergebnisse anzuzeigen, die den Suchkriterien entsprechen. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Preview
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Purge
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Hinweis: In Security & Compliance PowerShell ist dieser Schalter nur in der Rolle Suchen und Löschen verfügbar. Standardmäßig wird diese Rolle nur den Rollengruppen Organisationsverwaltung und Datenermittler zugewiesen.
Der Schalter Bereinigen gibt die Aktion für die Inhaltssuche an, um Elemente zu entfernen, die den Suchkriterien entsprechen. Sie müssen keinen Wert für diese Option angeben.
Aus jedem Postfach können maximal 10 Elemente gleichzeitig entfernt werden. Da die Funktion zum Suchen und Entfernen von Nachrichten ein Tool zur Reaktion auf Vorfälle sein soll, stellt dieser Höchstwert sicher, dass Nachrichten schnell aus Postfächern entfernt werden können. Diese Aktion ist nicht zum Aufräumen von Benutzerpostfächern gedacht.
Tipp: Informationen zum Bereinigen von mehr als 10 Elementen finden Sie unter ediscoverySearch: purgeData im Microsoft Graph-API, der das Bereinigen von maximal 100 Elementen pro Speicherort ermöglicht.
Sie können Elemente aus maximal 50.000 Postfächern mithilfe einer einzelnen Inhaltssuche entfernen. Um Elemente aus mehr als 50.000 Postfächern zu entfernen, müssen Sie separate Inhaltssuchen erstellen. Weitere Informationen finden Sie unter Suchen und Löschen von E-Mail-Nachrichten in Ihrem Microsoft 365-organization.
Nicht indizierte Elemente werden nicht aus Postfächern entfernt, wenn Sie diesen Schalter verwenden.
Der Wert des PurgeType-Parameters steuert, wie die Elemente entfernt werden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Purge
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PurgeType
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Hinweis: In Security & Compliance PowerShell ist dieser Parameter nur in der Rolle Suchen und Löschen verfügbar. Standardmäßig wird diese Rolle nur den Rollengruppen Organisationsverwaltung und Datenermittler zugewiesen.
Der Parameter PurgeType gibt an, wie Elemente zu entfernen sind, wenn die Aktion Purge lautet. Gültige Werte sind:
- SoftDelete: Gelöschte Elemente können von Benutzern wiederhergestellt werden, bis der Aufbewahrungszeitraum für gelöschte Elemente abläuft.
- HardDelete (nur Cloud): Gelöschte Elemente werden für die dauerhafte Entfernung aus dem Postfach markiert und endgültig entfernt, wenn das Postfach das nächste Mal vom Assistenten für verwaltete Ordner verarbeitet wird. Wenn die Wiederherstellung einzelner Elemente für das Postfach aktiviert ist, werden gelöschte Elemente nach Ablauf des Aufbewahrungszeitraums für gelöschte Elemente endgültig entfernt.
Parametereigenschaften
| Typ: | ComplianceDestroyType |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Purge
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ReferenceActionName
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Region
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Report
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Hinweis: Nach dem 26. Mai 2025 ist dieser Parameter nicht mehr funktionsfähig. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Die Option Bericht gibt an, dass die Aktion für die Inhaltssuche darin besteht, einen Bericht über die Ergebnisse (Informationen zu jedem Element anstelle des vollständigen Resultsets) zu exportieren, die den Suchkriterien entsprechen. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RetentionReport
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Hinweis: Nach dem 26. Mai 2025 ist dieser Parameter nicht mehr funktionsfähig. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
Die Option RetentionReport gibt an, dass die Aktion für die Inhaltssuche das Exportieren eines Aufbewahrungsberichts ist. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RetryOnError
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Die Option RetryOnError gibt an, ob die Aktion für Elemente wiederholt werden soll, bei denen ein Fehler aufgetreten ist, ohne dass die gesamte Aktion wiederholt werden muss. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Scenario
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
In Security & Compliance PowerShell erfordert dieser Parameter die Vorschaurolle. Standardmäßig wird diese Rolle nur der Rollengruppe eDiscovery-Manager zugewiesen.
Der Parameter Scenario gibt den Szenariotyp an. Gültige Werte sind:
- AnalyzeWithZoom: Bereiten Sie die Suchergebnisse für die Verarbeitung in Microsoft Purview eDiscovery Premium vor.
- General: Exportiert die Suchergebnisse auf den lokalen Computer. E-Mail-Nachrichten werden in PST-Dateien exportiert. SharePoint- und OneDrive-Dokumente werden in ihren nativen Office-Formaten exportiert.
- GenerateReportsOnly
- Inventar
- RetentionReports
- TriagePreview
Parametereigenschaften
| Typ: | ComplianceSearchActionScenario |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Scope
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Hinweis: Nach dem 26. Mai 2025 ist dieser Parameter nicht mehr funktionsfähig. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
Der Parameter Scope gibt die Elemente an, die für die Aktion Export einzuschließen sind. Gültige Werte sind:
- IndexedItemsOnly
- UnindexedItemsOnly
- BothIndexedAndUnindexedItems
Parametereigenschaften
| Typ: | ComplianceExportScope |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SearchName
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Der SearchName-Parameter gibt den Namen der vorhandenen Inhaltssuche an, die der Inhaltssuchaktion zugeordnet werden soll. Sie können mehrere Inhaltssuchen durch Kommas getrennt angeben.
Sie können die Inhaltssuche finden, indem Sie den Befehl Get-ComplianceSearch | Format-Table -Auto Name,Status.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SearchNames
Anwendbar: Security & Compliance
Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.
Der Parameter SearchNames gibt die Namen der vorhandenen Inhaltssuchen an, die der Inhaltssuchaktion zugeordnet werden sollen. Sie trennen die Namen der Inhaltssuche durch Kommas.
Sie können Die Namen der Inhaltssuche finden, indem Sie den Befehl Get-ComplianceSearch | Format-Table -Auto Name,Status.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SharePointArchiveFormat
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Hinweis: Nach dem 26. Mai 2025 ist dieser Parameter nicht mehr funktionsfähig. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Für diesen Parameter ist die Exportrolle erforderlich. Standardmäßig wird diese Rolle nur der Rollengruppe eDiscovery-Manager zugewiesen.
Der Parameter SharePointArchiveFormat gibt an, wie SharePoint- und OneDrive-Suchergebnisse exportiert werden. Gültige Werte sind:
- IndividualMessage: Exportieren Sie die Dateien unkomprimiert. Dieser Wert ist die Standardeinstellung.
- PerUserZip: Eine ZIP-Datei für jeden Benutzer. Jede ZIP-Datei enthält die exportierten Dateien für den Benutzer.
- SingleZip: Eine ZIP-Datei für alle Benutzer. Die ZIP-Datei enthält alle exportierten Dateien von allen Benutzern. Diese Ausgabeeinstellung ist nur in PowerShell verfügbar.
Verwenden Sie den Parameter ExchangeArchiveFormat, um das Format für Exchange-Suchergebnisse anzugeben.
Parametereigenschaften
| Typ: | ComplianceExportArchiveFormat |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ShareRootPath
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Dieser Parameter ist im lokalen Exchange verfügbar.
Hinweis: Nach dem 26. Mai 2025 ist dieser Parameter nicht mehr funktionsfähig. Weitere Informationen finden Sie unter Bevorstehende Änderungen an Microsoft Purview-eDiscovery.
{{ Fill ShareRootPath Description }}
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
Export
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Version
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance
Der WhatIf-Schalter funktioniert in Security & Compliance PowerShell nicht.
Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.