Set-ComplianceSearch

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 Set-ComplianceSearch, um nicht ausgeführte Konformitätssuchen in Exchange Server 2016 oder höher und im Microsoft Purview-Complianceportal zu ändern.

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

Syntax

Set-ComplianceSearch
   [-Identity] <ComplianceSearchIdParameter>
   [-AddExchangeLocation <String[]>]
   [-AddExchangeLocationExclusion <String[]>]
   [-AddSharePointLocation <String[]>]
   [-AddSharePointLocationExclusion <String[]>]
   [-AllowNotFoundExchangeLocationsEnabled <Boolean>]
   [-Confirm]
   [-ContentMatchQuery <String>]
   [-Description <String>]
   [-ExchangeLocation <String[]>]
   [-ExchangeLocationExclusion <String[]>]
   [-Force]
   [-HoldNames <String[]>]
   [-IncludeOrgContent <Boolean>]
   [-IncludeUserAppContent <Boolean>]
   [-Language <CultureInfo>]
   [-Name <String>]
   [-PublicFolderLocation <String[]>]
   [-RefinerNames <String[]>]
   [-RemoveExchangeLocation <String[]>]
   [-RemoveExchangeLocationExclusion <String[]>]
   [-RemovePublicFolderLocation <String[]>]
   [-RemoveSharePointLocation <String[]>]
   [-RemoveSharePointLocationExclusion <String[]>]
   [-SharePointLocation <String[]>]
   [-SharePointLocationExclusion <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den 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 Rolle Postfachsuche verfügbar. Standardmäßig wird diese Rolle nur der Rollengruppe Ermittlungsverwaltung zugewiesen.

Um dieses Cmdlet in PowerShell für Sicherheitskonformität & verwenden zu können, müssen Ihnen Berechtigungen zugewiesen werden. Weitere Informationen finden Sie unter Berechtigungen im Microsoft Purview-Complianceportal.

Beispiele

Beispiel 1

Set-ComplianceSearch -Identity "Project X" -ExchangeLocation All

In diesem Beispiel wird die vorhandene Kompatibilitätssuche mit dem Namen Project X geändert. Der Bereich der Exchange-Suche wird in alle Postfächer geändert.

Beispiel 2

Set-ComplianceSearch -Identity "Contoso Case Search 1" -HoldNames All -ExchangeLocation $null -SharePointLocation $null

In diesem Beispiel wird eine vorhandene Konformitätssuche geändert, die einem eDiscovery-Fall im Microsoft Purview-Complianceportal zugeordnet ist. Der Suchbereich wird vom Durchsuchen ausgewählter Postfächer und SharePoint-Websites in alle Inhaltsspeicherorte geändert, die im eDiscovery-Fall im Haltebereich platziert wurden.

Beispiel 3

Set-ComplianceSearch -Identity "China Subsidiary Search" -Language zh-CN

In diesem Beispiel wird die Spracheinstellung für eine vorhandene Kompatibilitätssuche in Chinesisch geändert.

Möglicherweise müssen Sie die Spracheinstellung ändern, wenn Sie nicht englische Schlüsselwörter in der Suchabfrage verwenden (die im ContentMatchQuery-Parameter angegeben ist).

Parameter

-AddExchangeLocation

Der AddExchangeLocation-Parameter gibt die Postfächer an, die der Liste der enthaltenen Postfächer hinzugefügt werden sollen, wenn Sie nicht den Wert All für den ExchangeLocation-Parameter verwenden. Gültige Werte sind:

  • Ein normales Benutzerpostfach. Das Einschließen anderer Arten von Postfächern (z. B. inaktive Postfächer oder Microsoft 365-Gastbenutzern) wird durch den Parameter AllowNotFoundExchangeLocationsEnabled gesteuert.
  • Ein Postfach

Verwenden Sie die E-Mail-Adresse, um ein Postfach oder eine Verteilergruppe anzugeben. Es können mehrere Werte durch Kommata getrennt angegeben werden.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-AddExchangeLocationExclusion

Dieser Parameter ist nur in lokalem Exchange funktionsfähig.

Dieser Parameter gibt die Postfächer an, die der Liste der ausgeschlossenen Postfächer hinzugefügt werden sollen, wenn Sie den Wert All für den ExchangeLocation-Parameter verwenden. Gültige Werte sind:

  • Ein normales Benutzerpostfach. Das Einschließen anderer Arten von Postfächern (z. B. inaktive Postfächer oder Microsoft 365-Gastbenutzern) wird durch den Parameter AllowNotFoundExchangeLocationsEnabled gesteuert.
  • Ein Postfach

Verwenden Sie die E-Mail-Adresse, um ein Postfach oder eine Verteilergruppe anzugeben. Es können mehrere Werte durch Kommata getrennt angegeben werden.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-AddSharePointLocation

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der AddSharePointLocation-Parameter gibt die SharePoint Online-Websites an, die der Liste der enthaltenen Websites hinzugefügt werden sollen, wenn Sie nicht den Wert All für den SharePointLocation-Parameter verwenden. Sie können die Website anhand ihres URL-Werts bestimmen.

Mehrere Werte können durch Kommata getrennt eingegeben werden. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddSharePointLocationExclusion

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AllowNotFoundExchangeLocationsEnabled

Der Parameter AllowNotFoundExchangeLocationsEnabled gibt an, ob andere Postfächer als normale Benutzerpostfächer in die Konformitätssuche einbezogen werden sollen. Gültige Werte sind:

  • $true: Die Suche versucht nicht, das Vorhandensein des Postfachs zu überprüfen, bevor der Vorgang fortgesetzt wird. Dieser Wert ist erforderlich, wenn Sie Postfächer durchsuchen möchten, die nicht als normale Postfächer aufgelöst werden.
  • $false: Die Suche versucht, das Vorhandensein des Postfachs zu überprüfen, bevor der Vorgang fortgesetzt wird. Wenn Sie ein Postfach angeben, das kein normales Benutzerpostfach ist, schlägt die Suche fehl. Dies ist der Standardwert.

Zu den Postfachtypen, die vom Wert dieses Parameters betroffen sind, gehören:

  • Inaktive Postfächer
  • Benutzer ohne Exchange Online-Lizenz, die Office-Anwendungen verwenden
  • Gastbenutzer
  • Lokale Benutzer, deren Identität mit Ihrer Microsoft 365-Organisation synchronisiert wird
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-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 2016, Exchange Server 2019, Security & Compliance

-ContentMatchQuery

Der ContentMatchQuery-Parameter gibt einen Inhaltssuchfilter an.

Dieser Parameter verwendet eine Textzeichenfolge oder eine Abfrage, die mithilfe der KQL (Keyword Query Language) formatiert wurde. Weitere Informationen finden Sie unter KQL-Syntaxreferenz (Keyword Query Language) und Schlüsselwortabfragen und Suchbedingungen für eDiscovery.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Description

Der Parameter Description gibt eine Beschreibung für die Compliance-Suche an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-ExchangeLocation

Der Parameter ExchangeLocation gibt die einzuschließden Postfächer an. Gültige Werte sind:

  • Ein normales Benutzerpostfach. Das Einschließen anderer Arten von Postfächern (z. B. inaktive Postfächer oder Microsoft 365-Gastbenutzern) wird durch den Parameter AllowNotFoundExchangeLocationsEnabled gesteuert.
  • Ein Postfach
  • Der Wert Alle für alle Postfächer. Dieser Wert kann nur alleine verwendet werden.

Verwenden Sie die E-Mail-Adresse, um ein Postfach oder eine Verteilergruppe anzugeben. Es können mehrere Werte durch Kommata getrennt angegeben werden.

Mehrere Werte können durch Kommata getrennt eingegeben werden. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-ExchangeLocationExclusion

Dieser Parameter ist nur in lokalem Exchange funktionsfähig.

Dieser Parameter gibt die Postfächer an, die ausgeschlossen werden sollen, wenn Sie den Wert All für den ExchangeLocation-Parameter verwenden. Gültige Werte sind:

  • Ein normales Benutzerpostfach. Das Einschließen anderer Arten von Postfächern (z. B. inaktive Postfächer oder Microsoft 365-Gastbenutzern) wird durch den Parameter AllowNotFoundExchangeLocationsEnabled gesteuert.
  • Ein Postfach

Verwenden Sie die E-Mail-Adresse, um ein Postfach oder eine Verteilergruppe anzugeben. Es können mehrere Werte durch Kommata getrennt angegeben werden.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Force

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-HoldNames

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter HoldNames gibt an, dass die Inhaltsspeicherorte, die im eDiscovery-Fall im Haltefeld platziert wurden, durchsucht werden. Verwenden Sie für diesen Parameter den Wert All. Sie können diesen Parameter nur für Konformitätssuchen verwenden, die einem eDiscovery-Fall zugeordnet sind.

Wenn die Inhaltsspeicherorte in der Kompatibilitätssuche Postfächer enthalten, müssen Sie auch den Parameter ExchangeLocation mit dem Wert $null verwenden. Wenn die Kompatibilitätssuche SharePoint-Websites umfasst, müssen Sie auch den SharePointLocation-Parameter mit dem Wert $null verwenden.

Wenn ein Inhaltsspeicherort in einem abfragebasierten Fallspeicher platziert wurde, werden nur Elemente durchsucht, die sich im Haltefeld befinden, wenn Sie diese Konformitätssuche neu starten. Wenn z. B. ein Benutzer in einen abfragebasierten Fallaufbewahrungsspeicher versetzt wurde, der Elemente beibehält, die vor einem bestimmten Datum gesendet oder erstellt wurden, werden nur diese Elemente mithilfe der von dieser Konformitätssuche angegebenen Suchkriterien durchsucht.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Identity

Der Parameter Identity gibt die Compliance-Suche an, die Sie ändern 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)

Type:ComplianceSearchIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-IncludeOrgContent

{{ Fill IncludeOrgContent Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-IncludeUserAppContent

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter IncludeUserAppContent gibt an, dass Sie den cloudbasierten Speicherort nach Benutzern durchsuchen möchten, die nicht über ein reguläres Microsoft 365-Benutzerkonto in Ihrer Organisation verfügen. Zu diesen Benutzertypen gehören Benutzer ohne Exchange Online-Lizenz, die Office-Anwendungen verwenden, Microsoft 365-Gastbenutzer und lokale Benutzer, deren Identität mit Ihrer Microsoft 365-Organisation synchronisiert wird. Gültige Werte sind:

  • $true: Der cloudbasierte Speicherort für die Benutzer, die in einem der Exchange-Standortparameter angegeben sind, wird in die Suche einbezogen. Wenn Sie den Wert Alle für den ExchangeLocation-Parameter verwenden, wird der cloudbasierte Speicherort für jeden Gast- oder lokalen Benutzer in die Suche einbezogen.
  • $false: Der cloudbasierte Speicherort für die im ExchangeLocation-Parameter angegebenen Benutzer wird nicht in die Suche einbezogen. Dies ist der Standardwert.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Language

Der Parameter Language gibt die Sprache für die Compliance-Suche an.

Gültige Eingabe für diesen Parameter ist ein unterstützter Kulturcodewert aus der Microsoft .NET Framework CultureInfo-Klasse. Beispiel: da-DK für Dänisch oder ja-JP für Japanisch. Weitere Informationen finden Sie unter CultureInfo-Klasse.

Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-Name

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-PublicFolderLocation

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter PublicFolderLocation gibt an, dass alle öffentlichen Ordner in die Suche einbezogen werden sollen. Verwenden Sie für diesen Parameter den Wert All.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RefinerNames

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveExchangeLocation

Der Parameter RemoveExchangeLocation gibt die Postfächer an, die aus der Liste der enthaltenen Postfächer entfernt werden sollen, wenn Sie nicht den Wert All für den ExchangeLocation-Parameter verwenden. Gültige Werte sind:

  • Dieser Parameter gibt die Postfächer an, die aus der Liste der ausgeschlossenen Postfächer entfernt werden, wenn der Wert All für den ExchangeLocation-Parameter verwendet wird. Gültige Werte sind:
  • Ein Postfach

Verwenden Sie die E-Mail-Adresse, um ein Postfach oder eine Verteilergruppe anzugeben. Es können mehrere Werte durch Kommata getrennt angegeben werden.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-RemoveExchangeLocationExclusion

Dieser Parameter ist nur in lokalem Exchange funktionsfähig.

Dieser Parameter gibt die Postfächer an, die aus der Liste der ausgeschlossenen Postfächer entfernt werden sollen, wenn Sie den Wert All für den ExchangeLocation-Parameter verwenden. Gültige Werte sind:

  • Dieser Parameter gibt die Postfächer an, die aus der Liste der ausgeschlossenen Postfächer entfernt werden, wenn der Wert All für den ExchangeLocation-Parameter verwendet wird. Gültige Werte sind:
  • Ein Postfach

Verwenden Sie die E-Mail-Adresse, um ein Postfach oder eine Verteilergruppe anzugeben. Es können mehrere Werte durch Kommata getrennt angegeben werden.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Security & Compliance

-RemovePublicFolderLocation

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocation

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der RemoveSharePointLocation-Parameter gibt die SharePoint Online-Websites an, die aus der Liste der eingeschlossenen Websites entfernt werden sollen, wenn Sie nicht den Wert All für den SharePointLocation-Parameter verwenden. Sie können die Website anhand ihres URL-Werts bestimmen.

Mehrere Werte können durch Kommata getrennt eingegeben werden. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocationExclusion

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SharePointLocation

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter SharePointLocation gibt die einzuschließenden SharePoint Online-Websites an. Sie identifizieren die Website anhand ihres URL-Werts, oder Sie können den Wert Alle verwenden, um alle Websites einzuschließen.

Mehrere Werte können durch Kommata getrennt eingegeben werden. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SharePointLocationExclusion

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-WhatIf

Der WhatIf-Schalter funktioniert in PowerShell für Sicherheitskonformität & nicht.

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 2016, Exchange Server 2019, Security & Compliance