New-ComplianceSearchAction
Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen sind möglicherweise exklusiv für die eine oder andere Umgebung.
Verwenden Sie das New-ComplianceSearchAction Cmdlet, um Aktionen für Inhaltssuchen in Exchange Server und in Microsoft Purview zu erstellen.
Hinweis: Einige der Parameter in diesem Cmdlet sind nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Änderungen an Microsoft Purview-eDiscovery.
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.
Im lokalen Exchange ist dieses Cmdlet in der Rolle "Postfachsuche" 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 PowerShell-Modul von Exchange Online. Für die Installation dieser Version des Moduls müssen Sie möglicherweise vorherige Versionen des Moduls löschen.
- Führen Sie den Befehl Connect-IPPSSession mit der Option EnableSearchOnlySession aus.
Beispiele
Beispiel 1
New-ComplianceSearchAction -SearchName "Project X" -Preview
In diesem Beispiel wird eine Vorschau der Suchaktion für die Inhaltssuche mit dem Namen Projekt X erstellt.
Beispiel 2
New-ComplianceSearchAction -SearchName "Project X" -Export
In diesem Beispiel wird eine Exportsuchaktion für die Inhaltssuche mit dem Namen Projekt X erstellt.
Hinweis: Dieses Beispiel funktioniert nur in einem lokalen Exchange-Gerät. Weitere Informationen finden Sie unter Mai 2025 Ä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 "Phishingnachricht entfernen" zurückgegeben werden. Nicht indizierte Elemente werden nicht gelöscht, wenn Sie den Parameter "Bereinigen" 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 umfasste, werden die Suchergebnisse als eine PST-Datei pro Postfach exportiert.
Hinweis: Dieses Beispiel funktioniert nur in einem lokalen Exchange-Gerät. Weitere Informationen finden Sie unter Mai 2025 Änderungen an Microsoft Purview-eDiscovery.
Parameter
-ActionName
Anwendbar: Sicherheit & Compliance
Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.
Der ActionName-Parameter gibt einen Namen für die Inhaltssuchaktion an. Sie verwenden diesen Parameter nur, wenn Sie mehrere Inhaltssuchen im Parameter SearchName 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.
Um das Format für Exchange-Suchergebnisse anzugeben, verwenden Sie den Parameter ExchangeArchiveFormat. Um das Format für SharePoint- und OneDrive-Suchergebnisse anzugeben, verwenden Sie den SharePointArchiveFormat-Parameter.
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 sich diese Option auf das Cmdlet auswirkt, hängt davon ab, ob für das Cmdlet eine Bestätigung erforderlich ist, bevor Sie fortfahren.
- 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 die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.
Dieses Cmdlet verfügt über eine integrierte Pause, die Sie zum Überspringen der Bestätigung verwenden können -Confirm:$false .
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: Sicherheit & 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: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Änderungen an Microsoft Purview-eDiscovery.
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Dieser Parameter erfordert die Exportrolle in Security & Compliance PowerShell. 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 der Standardwert.
- 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 SharePointArchiveFormat-Parameter.
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: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Änderungen an Microsoft Purview-eDiscovery.
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Dieser Parameter erfordert die Exportrolle in Security & Compliance PowerShell. 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: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Änderungen an Microsoft Purview-eDiscovery.
FileTypeExclusionsForUnindexedItems gibt die Dateitypen an, die ausgeschlossen werden sollen, 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 erfordert dieser Parameter die Exportrolle. 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 beim Exportieren von Suchergebnissen aus dem Microsoft Purview-Complianceportal verfügbar ist.
- Mime: Export to .eml message files. Dies ist der Standardwert, wenn Sie Cmdlets verwenden, um die Suchergebnisse zu exportieren.
- Meldung: Export to .msg message files.
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
Der Schalter IncludeCredential gibt an, ob die Anmeldeinformationen in die Ergebnisse einbezogen 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: Sicherheit & Compliance
Hinweis: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Ä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 der Standardwert.
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: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Änderungen an Microsoft Purview-eDiscovery.
In Security & Compliance PowerShell erfordert dieser Parameter die Exportrolle. 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: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Änderungen an Microsoft Purview-eDiscovery.
In Security & Compliance PowerShell erfordert dieser Parameter die Exportrolle. 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
Hinweis: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Änderungen an Microsoft Purview-eDiscovery.
In Security & Compliance PowerShell erfordert dieser Parameter die Preview-Rolle. Standardmäßig wird diese Rolle nur der Rollengruppe "eDiscovery-Manager" zugewiesen.
Der Schalter Vorschau gibt an, dass die Aktion für die Inhaltssuche darin besteht, 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 diese Option nur in der Rolle Suchen und Löschen verfügbar. Standardmäßig wird diese Rolle nur den Rollengruppen "Organisationsverwaltung" und "Datenermittler" zugewiesen.
Der Schalter "Löschen" gibt an, dass die Aktion für die Inhaltssuche darin besteht, 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: Wenn Sie mehr als 10 Elemente entfernen möchten, lesen Sie ediscoverySearch: purgeData in der Microsoft Graph-API, die maximal 100 Elemente pro Position löschen kann.
Mit einer einzigen Inhaltssuche können Sie Elemente aus maximal 50.000 Postfächern 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 Ihrer Microsoft 365 organization.
Nicht indizierte Elemente werden nicht aus den Postfächern entfernt, wenn Sie diese Option 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:
- Vorläufiges Löschen: Gelöschte Elemente können von Benutzern wiederhergestellt werden, bis der Aufbewahrungszeitraum für gelöschte Elemente abgelaufen ist.
- HardDelete (nur Cloud): Bereinigte Elemente werden zur dauerhaften Entfernung aus dem Postfach markiert und bei der nächsten Verarbeitung des Postfachs durch den Assistenten für verwaltete Ordner dauerhaft entfernt. Wenn die Wiederherstellung einzelner Elemente für das Postfach aktiviert ist, werden gelöschte Elemente nach Ablauf des Aufbewahrungszeitraums für gelöschte Elemente dauerhaft 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: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Änderungen an Microsoft Purview-eDiscovery.
Dieser Parameter ist nur im cloudbasierten Dienst funktionsfähig.
Der Schalter 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 Satzes von Ergebnissen) 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: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Änderungen an Microsoft Purview-eDiscovery.
Der Schalter RetentionReport gibt an, dass die Aktion für die Inhaltssuche darin besteht, einen Aufbewahrungsbericht zu exportieren. 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 Preview-Rolle. Standardmäßig wird diese Rolle nur der Rollengruppe "eDiscovery-Manager" zugewiesen.
Der Parameter Scenario gibt den Szenariotyp an. Gültige Werte sind:
- AnalyzeWithZoom: Vorbereiten der Suchergebnisse für die Verarbeitung in Microsoft Purview eDiscovery Premium.
- 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: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Ä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 Parameter SearchName gibt den Namen der vorhandenen Inhaltssuche an, die der Inhaltssuchaktion zugeordnet werden soll. Sie können mehrere Inhaltssuchen durch Kommas getrennt angeben.
Sie finden die Inhaltssuche, 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: Sicherheit & 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: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Ä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 SharePointArchiveFormat-Parameter gibt an, wie SharePoint- und OneDrive-Suchergebnisse exportiert werden. Gültige Werte sind:
- IndividualMessage: Exportieren Sie die Dateien unkomprimiert. Dieser Wert ist der Standardwert.
- 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.
Um das Format für Exchange-Suchergebnisse anzugeben, verwenden Sie den Parameter ExchangeArchiveFormat.
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: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Ä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.
Der Schalter "WhatIf" zeigt die Funktion des Befehls an, ohne Änderungen vorzunehmen. 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.