Freigeben über

Get-ComplianceSearch

Modul:
Exchange PowerShell

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 Get-ComplianceSearch, um die Suche nach der Geschätzten Konformität in Exchange Server 2016 oder höher und im Microsoft Purview-Complianceportal anzuzeigen. Nachdem Sie das Cmdlet New-ComplianceSearchAction verwendet haben, um eine Vorschauaktion für die Compliancesuche zu definieren, verwenden Sie das Cmdlet Get-ComplianceSearchAction, um die Ergebnisse der Compliancesuche anzuzeigen.

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

Syntax

Default (Standard) 

Get-ComplianceSearch
    [[-Identity] <ComplianceSearchIdParameter>]
    [-Case <String>]
    [-DomainController <Fqdn>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Beschreibung

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 lokalem Exchange ist dieses Cmdlet in der Postfachsuche-Rolle 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-ComplianceSearch

In diesem Beispiel wird eine zusammenfassende Liste aller Compliancesuchen gezeigt.

Beispiel 2

Get-ComplianceSearch -Identity "Case 1234" | Format-List

In diesem Beispiel werden Details der Compliancesuche namens „Case 1234“ gezeigt.

Parameter

-Case

Anwendbar: Security & Compliance

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Case-Parameter filtert die Ergebnisse nach dem Namen einer eDiscovery Standard Fall, dem die Konformitätssuche zugeordnet ist. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Sie können diesen Parameter nicht verwenden, um Compliancesuchen anzuzeigen, die eDiscovery Premium-Fällen zugeordnet sind.

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

-DomainController

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

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

-Identity

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance

Der Parameter Identity gibt die Compliancesuche an, die Sie anzeigen möchten.

Bei Verwendung dieses Parameters ist der Identity-Parameter erforderlich, der Wert wird jedoch ignoriert. Verwenden Sie z. B. den Wert 000 für den Identity-Parameter.

  • Name
  • JobRunId (GUID)

JobRunId (GUID)

Um die Leistung dieses Cmdlets zu verbessern, werden einige Compliancesucheigenschaften nicht zurückgegeben, wenn Sie die Identität der Compliancesuche nicht angeben. Die Eigenschaften lauten wie folgt:

  • Elemente
  • Size
  • SuccessResults
  • NumBindings
  • ExchangeLocation
  • SharePointLocation
  • OneDriveLocation

Wenn Sie diese Eigenschaften anzeigen möchten, müssen Sie den Parameter Identity im Befehl verwenden.

Hinweis: Die NumBindings-Eigenschaft enthält das primäre Postfach, das Hauptarchiv und alle zusätzlichen Archive für Benutzer, die in der Suche enthalten sind. NumBindings ist nicht die Anzahl der Benutzer, die in der Suche enthalten sind, da jeder eingeschlossene Benutzer eine Kombination aus einem primären Postfach, einem Hauptarchiv und zusätzlichen Archiven haben könnte oder nicht.

Achtung: Der Wert $null oder ein nicht vorhandener Wert für den Identity-Parameter gibt alle Objekte zurück, als ob Sie den Get-Befehl ohne den Identity-Parameter ausgeführt haben. Vergewissern Sie sich, dass listen von Werten für den Identity-Parameter korrekt sind und keine nicht vorhandenen $null-Werte enthalten.

Parametereigenschaften

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

Parametersätze

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

-ResultSize

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Security & Compliance

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.