Search-Mailbox

Referenz

Modul:: ExchangePowerShell

Gilt für::: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen gelten exklusiv für die eine oder andere Umgebung.

Verwenden Sie das Cmdlet Search-Mailbox, um ein Postfach zu durchsuchen und die Ergebnisse in ein bestimmtes Zielpostfach zu kopieren oder um Nachrichten aus dem Postfach zu löschen (oder beides).

Hinweis: In cloudbasierten Umgebungen ist das Cmdlet Search-Mailbox zugunsten von New-ComplianceSearch und verwandten eDiscovery-Cmdlets veraltet.

Standardmäßig ist Search-Mailbox nur in den Rollen Postfachsuche oder Postfachimportexport verfügbar, und diese Rollen sind keiner Rollengruppe zugewiesen. Um dieses Cmdlet verwenden zu können, müssen Sie einer Rollengruppe (z. B. der Rollengruppe Organisationsverwaltung) eine oder beide Rollen hinzufügen. Nur die Rolle "Postfachimportexport" gewährt Ihnen Zugriff auf den DeleteContent-Parameter. Weitere Informationen zum Hinzufügen von Rollen zu Rollengruppen finden Sie unter Hinzufügen einer Rolle zu einer Rollengruppe.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Search-Mailbox
      [-Identity] <MailboxOrMailUserIdParameter>
      [-Confirm]
      [-DeleteContent]
      [-DomainController <Fqdn>]
      [-DoNotIncludeArchive]
      [-Force]
      [-IncludeUnsearchableItems]
      [-SearchDumpster]
      [-SearchDumpsterOnly]
      [-SearchQuery <String>]
      [-WhatIf]
      [<CommonParameters>]

Search-Mailbox
      [-Identity] <MailboxOrMailUserIdParameter>
      [-EstimateResultOnly]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-DoNotIncludeArchive]
      [-Force]
      [-IncludeUnsearchableItems]
      [-SearchDumpster]
      [-SearchDumpsterOnly]
      [-SearchQuery <String>]
      [-WhatIf]
      [<CommonParameters>]

Search-Mailbox
      [-Identity] <MailboxOrMailUserIdParameter>
      -TargetFolder <String>
      -TargetMailbox <MailboxIdParameter>
      [-Confirm]
      [-DeleteContent]
      [-DomainController <Fqdn>]
      [-DoNotIncludeArchive]
      [-Force]
      [-IncludeUnsearchableItems]
      [-LogLevel <LoggingLevel>]
      [-LogOnly]
      [-SearchDumpster]
      [-SearchDumpsterOnly]
      [-SearchQuery <String>]
      [-WhatIf]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Search-Mailbox kann für die Suche nach Nachrichten in einem angegebenen Postfach und zum Ausführen der folgenden Aufgaben verwendet werden:

Kopieren von Nachrichten in ein angegebenes Zielpostfach.
Löschen von Nachrichten aus dem Quellpostfach. Sie müssen die Verwaltungsrolle "Postfachimport/-export" haben, um Nachrichten löschen zu können.
Wiederherstellen einzelner Elemente, um Elemente aus dem Ordner Wiederherstellbare Elemente eines Benutzers wiederherzustellen.
Bereinigen des Ordners Wiederherstellbare Elemente für ein Postfach, wenn die harte Kontingentgrenze für wiederherstellbare Elemente erreicht wurde.

Beispiele

Beispiel 1

Search-Mailbox -Identity "Joe Healy" -SearchQuery "Subject:Project Hamilton" -TargetMailbox "DiscoveryMailbox" -TargetFolder "JoeHealy-ProjectHamilton" -LogLevel Full

In diesem Beispiel wird das Postfach von Joe Healy durchsucht und werden die Suchergebnisse in das Discoverypostfach im Ordner "JoeHealy-ProjectHamilton" kopiert.

Beispiel 2

Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -TargetMailbox "administrator" -TargetFolder "SearchAndDeleteLog" -LogOnly -LogLevel Full

In diesem Beispiel wird das Postfach von April Stewart nach Nachrichten durchsucht, die den Ausdruck "Ihr Kontoauszug" im Betreff enthalten, und das Ergebnis wird im Ordner SearchAndDeleteLog im Postfach des Administrators protokolliert. Nachrichten werden nicht in das Zielpostfach kopiert.

Beispiel 3

Search-Mailbox -Identity "April Stewart" -SearchQuery 'Subject:"Your bank statement"' -DeleteContent

In diesem Beispiel wird das Postfach von April Stewart nach Nachrichten durchsucht, die den Ausdruck "Ihr Kontoauszug" im Betreff enthalten, und die Nachrichten werden aus dem Quellpostfach gelöscht. Ihnen muss die Verwaltungsrolle Postfachimportexport zugewiesen sein, um den DeleteContent-Schalter verwenden zu können.

Beispiel 4

Get-Mailbox | Search-Mailbox -SearchQuery 'election OR candidate OR vote' -TargetMailbox "Discovery Search Mailbox" -TargetFolder "AllMailboxes-Election" -LogLevel Full

In diesem Beispiel werden alle Postfächer in Ihrer Organisation nach Nachrichten durchsucht, welche die Wörter "election", "candidate" oder "vote" enthalten. Die Suchergebnisse werden in das Discoverysuchpostfach im Ordner "AllMailboxes-Election" kopiert.

Parameter

-Confirm

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 (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
Die meisten anderen Cmdlets (z. B. 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.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DeleteContent

Hinweis: Ihnen muss die Verwaltungsrolle Postfachimportexport zugewiesen sein, um diesen Schalter verwenden zu können. Standardmäßig ist diese Rolle keiner Rollengruppe (einschließlich Organisationsverwaltung) zugewiesen. Normalerweise können Sie eine Role einer eingebauten oder benutzerdefinierten Rollengruppe zuordnen.

Die Option DeleteContent gibt an, dass die bei der Suche zurückgegebenen Nachrichten permanent aus dem Quellpostfach gelöscht werden. Sie müssen bei dieser Option keinen Wert angeben.

Wenn Sie diesen Schalter mit dem Parameter TargetMailbox verwenden, werden Nachrichten in das Zielpostfach kopiert und aus dem Quellpostfach entfernt. Wenn Sie die Protokollierungsstufe für die Suche auf Basic oder Full festlegen, müssen Sie ein Zielpostfach und einen Zielordner für das Protokoll angeben. Zum Löschen von Nachrichten aus dem Quellpostfach, ohne diese in das Zielpostfach zu kopieren, geben Sie die Parameter TargetMailbox, TargetFolder und LogLevel nicht an.

Vor der Verwendung der Option DeleteContent zum Löschen von Inhalten sollten Sie mithilfe des Parameters LogOnly Suchparameter testen, wie in Beispiel 2 gezeigt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DoNotIncludeArchive

Die Option DoNotIncludeArchive gibt an, dass das Archivpostfach des Benutzers nicht in die Suche eingebunden werden soll. Sie müssen keinen Wert für diese Option angeben.

Standardmäßig wird das Archivpostfach immer durchsucht.

Wenn die automatisch erweiterte Archivierung für ein Exchange Online Postfach aktiviert ist, wird nur das primäre Archivpostfach des Benutzers durchsucht. Zusätzliche Archivpostfächer werden nicht in die Suche einbezogen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-EstimateResultOnly

Der Schalter EstimateResultOnly gibt nur eine Schätzung der Gesamtzahl und Größe von Nachrichten zurück. Nachrichten werden nicht in das Zielpostfach kopiert. Sie müssen keinen Wert für diese Option angeben.

Sie können diese Option nicht mit dem Parameter TargetMailbox verwenden.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Force

Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.

Verwenden Sie diesen Schalter, um die Bestätigungsaufforderung auszublenden, wenn Sie den DeleteContent-Schalter zum endgültigen Löschen von Nachrichten verwenden.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

Der Parameter Identity gibt die Identität des zu durchsuchenden Postfachs an. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:

Name
Alias
Distinguished Name (DN)
Distinguished Name (DN)
Domäne\benutzername
E-Mail-Adresse
GUID
LegacyExchangeDN
SamAccountName
Benutzer-ID oder User Principal Name (UPN)

Type:	MailboxOrMailUserIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeUnsearchableItems

Die Option IncludeUnsearchableItems enthält Elemente, die von der Exchange-Suche nicht indiziert werden konnten, in den Suchergebnissen. Sie müssen bei dieser Option keinen Wert angeben.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-LogLevel

Der Parameter LogLevel gibt den Protokolliergrad für die Suche an. Einer der folgenden Werte ist möglich:

Unterdrücken: Es werden keine Protokolle gespeichert.
Basic: Grundlegende Informationen zur Abfrage und zur Person, die sie ausgeführt hat, werden beibehalten.
Vollständig: Zusätzlich zu den Informationen, die von der Protokollebene "Basic" gespeichert werden, fügt die Vollständige Protokollebene eine vollständige Liste der Suchergebnisse hinzu.

Die standardmäßige Protokollierungsstufe lautet Basic.

Wenn Sie diesen Parameter eingefügt haben, wird eine E-Mail-Nachricht erstellt und an das postfach gesendet, das durch den TargetMailbox-Parameter angegeben wird. Die Protokolldatei (eine CSV-formatierte Datei mit dem Namen Search Results.csv) ist an diese E-Mail-Nachricht angefügt und befindet sich in dem Ordner, der durch den Parameter TargetFolder angegeben wird. Die Protokolldatei enthält eine Zeile für jede Nachricht, die in den vom Cmdlet Search-Mailbox zurückgegebenen Suchergebnissen aufgeführt ist.

Type:	LoggingLevel
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-LogOnly

Der Schalter LogOnly führt eine Suche aus, generiert jedoch nur ein Protokoll. Bei der Suche zurückgegebene Nachrichten werden nicht in das Zielpostfach kopiert. Sie müssen bei dieser Option keinen Wert angeben.

Die Protokollierungsstufe wird mithilfe des Parameters LogLevel angegeben.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SearchDumpster

Die Option SearchDumpster gibt an, ob der Ordner "Wiederherstellbare Elemente" in die Suche eingeschlossen werden soll. Der Ordner Wiederherstellbare Elemente speichert Elemente, die aus dem Ordner Gelöschte Elemente gelöscht wurden, oder Elemente, die endgültig gelöscht wurden, bis sie aus der Postfachdatenbank gelöscht wurden.

Standardmäßig ist der Ordner "Wiederherstellbare Elemente" immer in der Suche enthalten. Um den Ordner "Wiederherstellbare Elemente" aus der Suche auszuschließen, verwenden Sie genau die folgende Syntax: -SearchDumpster:$false.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SearchDumpsterOnly

Die Option SearchDumpsterOnly gibt an, dass nur der Ordner "Wiederherstellbare Elemente" des angegebenen Postfachs durchsucht wird. Sie müssen keinen Wert für diese Option angeben.

Der Ordner Wiederherstellbare Elemente speichert Elemente, die aus dem Ordner Gelöschte Elemente gelöscht wurden, oder Elemente, die endgültig gelöscht wurden, bis sie aus der Postfachdatenbank gelöscht wurden.

Diese Option kann auch mit der Option DeleteContent verwendet werden, um Nachrichten aus dem Ordner Wiederherstellbare Elemente zu löschen und die Größe des Ordners zu reduzieren.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SearchQuery

Der Parameter SearchQuery gibt eine Suchzeichenfolge oder eine Abfrage an, die mithilfe der KQL (Keyword Query Language) formatiert wurde. Weitere Informationen zu KQL in Exchange finden Sie unter Nachrichteneigenschaften und Suchoperatoren für In-Place eDiscovery.

Ist dieser Parameter leer, werden alle Nachrichten zurückgegeben.

Hinweis: Das Cmdlet Search-Mailbox gibt bis zu 1.000 Ergebnisse pro Postfach zurück, wenn eine Suchabfrage angegeben ist.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetFolder

Der Parameter TargetFolder gibt einen Ordner zum Speichern von Suchergebnissen im Zielpostfach an. Der Ordner wird bei der Ausführung im Zielpostfach erstellt.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-TargetMailbox

Der Parameter TargetMailbox gibt das Zielpostfach an, in das Suchergebnisse kopiert werden. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:

Name
Alias
Distinguished Name (DN)
Distinguished Name (DN)
Domäne\benutzername
E-Mail-Adresse
GUID
LegacyExchangeDN
SamAccountName
Benutzer-ID oder User Principal Name (UPN)

Sie müssen diesen Parameter mit dem Parameter TargetFolder verwenden. Sie können diesen Parameter nicht mit der Option EstimateResultOnly verwenden.

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-WhatIf

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.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.