Stop-HistoricalSearch

Modul:
Exchange PowerShell

Dieses Cmdlet ist nur im cloudbasierten Dienst verfügbar.

Verwenden Sie das Cmdlet Stop-HistoricalSearch, um eine vorhandene Verlaufssuche zu beenden, die den status Wert NotStarted aufweist.

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

Syntax

Default (Standard) 

Stop-HistoricalSearch
    -JobId <Guid>
    [<CommonParameters>]

Beschreibung

Eine Verlaufssuche bietet Nachrichtenablaufverfolgung und Berichtsdetails in einer CSV-Datei (Comma-separated value) für Nachrichten, die weniger als 90 Tage alt sind.

Nachdem Sie eine Verlaufssuche mithilfe des Start-HistoricalSearch Cmdlets gestartet haben, wird die Suche in die Warteschlange eingereiht, aber nicht ausgeführt. Während sich die Suche in der Warteschlange befindet und den status Wert NotStarted aufweist, können Sie sie mit dem Stop-HistoricalSearch Cmdlet beenden. Nachdem die Suche aktiv ausgeführt wird und den Status InProgress aufweist, können Sie sie nicht mehr beenden. Wenn Sie eine historische Suche beenden, wird ihr der Statuswert "Abgebrochen" 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.

Beispiele

Beispiel 1

Stop-HistoricalSearch -JobId f9c66f83-b5c8-4a0c-91f4-a38376f74182

Dieses Beispiel beendet die historische Suche mit dem JobId-Wert f9c66f83-b5c8-4a0c-91f4-a38376f74182.

Parameter

-JobId

Anwendbar: Exchange Online, integriertes Sicherheits-Add-On für lokale Postfächer

Der Parameter JobId gibt den Identitäts-GUID-Wert der historischen Suche an, die Sie beenden möchten.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
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.

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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.