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 AllIn 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 $nullIn 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-CNIn 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 |