Get-ComplianceSearchAction

Modul:: Exchange PowerShell

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 Cmdlet Get-ComplianceSearchAction, um Informationen zu Compliancesuchaktionen anzuzeigen.

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

Syntax

Identity

Get-ComplianceSearchAction
    [[-Identity] <ComplianceSearchActionIdParameter>]
    [-Case <String>]
    [-Details]
    [-DomainController <Fqdn>]
    [-IncludeCredential]
    [-Organization <OrganizationIdParameter>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Preview

Get-ComplianceSearchAction
    [-Preview]
    [-Case <String>]
    [-Details]
    [-DomainController <Fqdn>]
    [-IncludeCredential]
    [-Organization <OrganizationIdParameter>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Purge

Get-ComplianceSearchAction
    [-Purge]
    [-Case <String>]
    [-Details]
    [-DomainController <Fqdn>]
    [-IncludeCredential]
    [-Organization <OrganizationIdParameter>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Export

Get-ComplianceSearchAction
    [-Export]
    [-Case <String>]
    [-Details]
    [-DomainController <Fqdn>]
    [-IncludeCredential]
    [-Organization <OrganizationIdParameter>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Beschreibung

Weisen Sie, nachdem Sie eine Compliance-Suche mit dem New-ComplianceSearch-Cmdlet erstellt und ausgeführt und die Suche mit dem Start-ComplianceSearch-Cmdlet gestartet haben, eine Suchaktion mit dem New-ComplianceSearchAction-Cmdlet zu. Verwenden Sie das Get-ComplianceSearchAction-Cmdlet, um den Fortschritt der Compliance-Suchaktion nachzuverfolgen.

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.

Im lokalen Exchange ist dieses Cmdlet in der Rolle "Postfachsuche" verfügbar. Standardmäßig wird diese Rolle nur der Rollengruppe "Ermittlungsverwaltung" zugewiesen.

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.

Beispiele

Beispiel 1

Get-ComplianceSearchAction

In diesem Beispiel wird eine zusammenfassende Liste aller Compliance-Suchaktionen dargestellt.

Beispiel 2

Get-ComplianceSearchAction -Identity "Case 1234_Preview" | Format-List

In diesem Beispiel werden detaillierte Informationen zur Compliance-Suchaktion "Case 1234_Preview" dargestellt.

Parameter

-Case

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter Fall filtert die Ergebnisse nach dem Namen des angegebenen Falls. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

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

-Details

Die Details-Option gibt an, ob ausführliche Informationen in den Ergebnissen angezeigt werden. 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

-DomainController

Dieser Parameter ist nur in lokalem Exchange funktionsfähig.

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.

Parametereigenschaften

Typ:	Fqdn
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

-Export

Hinweis: Dieser Parameter ist nur in lokalen Exchange-Versionen funktionsfähig. Weitere Informationen finden Sie unter Mai 2025 Änderungen an Microsoft Purview-eDiscovery.

Der Export-Schalter filtert die Ergebnisse nach Compliance-Export-Suchaktionen. Sie müssen keinen Wert für diese Option angeben.

Sie können diese Option nicht mit den Parametern Identity, Preview oder Purge verwenden.

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

-Identity

Der Identity-Parameter gibt die Compliance-Suchaktion an, die Sie anzeigen möchten. Sie können jeden Wert verwenden, der die Compliancesuchaktion eindeutig bestimmt. Zum Beispiel:

Name: Der Name der Compliance-Suchaktion verwendet die Syntax "Compliance Search Name_Action". Beispiel: "Case 1234_Preview".
JobRunId (GUID)

Sie können diesen Parameter nicht mit den Parametern "Export", "Preview" oder "Purge" verwenden.

Wenn Sie den Parameter "Identity" verwenden, werden weitere Details in den Ergebnissen zurückgegeben. Zum Beispiel:

In der Zeile "Ergebnisse" werden die Werte der Eigenschaften "Artikelanzahl", "Gesamtgröße" und "Details" aufgefüllt.
Den Ergebnissen werden Standortlinien hinzugefügt.
Der Eigenschaftswert NumBindings wird ausgefüllt. Diese Eigenschaft umfasst das primäre Postfach, das Hauptarchiv und alle zusätzlichen Archive für die Benutzer, die in die Suche einbezogen werden. NumBindings ist nicht die Anzahl der Benutzer, die in die Suche einbezogen werden, da jeder eingeschlossene Benutzer über eine Kombination aus einem primären Postfach, einem Hauptarchiv und zusätzlichen Archiven verfügen kann oder nicht.
Die betroffenen Standorteigenschaften (z. B. ExchangeLocation) werden ausgefüllt.
Der CaseName-Eigenschaftswert wird ausgefüllt.

Vorsicht: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte so zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt hätten. Überprüfen Sie, ob alle Wertelisten für den Parameter "Identity" korrekt sind und keine nicht vorhandenen $null-Werte enthalten.

Parametereigenschaften

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

Parametersätze

Identity

Position:	1
Obligatorisch:	False
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-IncludeCredential

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

-Organization

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Parametereigenschaften

Typ:	OrganizationIdParameter
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

-Preview

Die Preview-Option filtert die Ergebnisse nach Compliance-Preview-Suchaktionen. Sie müssen keinen Wert für diese Option angeben.

Sie können diese Option nicht mit den Parametern "Exportieren", "Identität" oder "Löschen" verwenden.

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

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.

Die Purge-Option filtert die Ergebnisse nach Compliance-Purge-Suchaktionen. Sie müssen keinen Wert für diese Option angeben.

Sie können diese Option nicht mit den Parametern "Exportieren", "Identität" oder "Vorschau" verwenden.

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

-ResultSize

Der ResultSize-Parameter gibt die maximale Anzahl von zurückzugebenden Ergebnissen an. Wenn Sie alle Anforderungen zurückgeben möchten, die der Abfrage entsprechen, verwenden Sie unlimited als Wert für diesen Parameter. Der Standardwert ist 1000.

Parametereigenschaften

Typ:	Unlimited
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

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.

Feedback

War diese Seite hilfreich?