Set-ComplianceSecurityFilter
Dieses Cmdlet ist nur in PowerShell für Sicherheitskonformität & funktionsfähig. Weitere Informationen finden Sie unter Security & Compliance PowerShell.
Verwenden Sie das Cmdlet Set-ComplianceSecurityFilter, um Konformitätssicherheitsfilter 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-ComplianceSecurityFilter
-FilterName <String>
[-Action <ComplianceSecurityFilterActionType>]
[-Confirm]
[-Description <String>]
[-Filters <MultiValuedProperty>]
[-Region <String>]
[-Users <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Beschreibung
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
$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"
$filterusers.users.add("pilarp@contoso.com")
Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.usersIn diesem Beispiel wird dem Konformitätssicherheitsfilter mit dem Namen Ottawa-Benutzerfilter ein Benutzer pilarp@contoso.com hinzugefügt, ohne dass sich dies auf andere Benutzer auswirkt, die dem Filter zugewiesen sind.
Beispiel 2
$filterusers = Get-ComplianceSecurityFilter -FilterName "Ottawa Users Filter"
$filterusers.users.remove("annb@contoso.com")
Set-ComplianceSecurityFilter -FilterName OttawaUsersFilter -Users $filterusers.usersIn diesem Beispiel wird der Benutzer annb@contoso.com in den Konformitätssicherheitsfilter mit dem Namen Ottawa-Benutzerfilter entfernt, ohne dass sich dies auf andere Benutzer auswirkt, die dem Filter zugewiesen sind.
Parameter
-Action
Der Action-Parameter gibt den Typ der Suchaktion an, auf die der Filter angewendet wird. Ein gültiger Wert für diesen Parameter ist All, was bedeutet, dass der Filter auf alle Suchaktionen angewendet wird.
- Exportieren: Der Filter wird angewendet, wenn Suchergebnisse exportiert oder für die Analyse in eDiscovery Premium vorbereitet werden.
- Vorschau: Der Filter wird bei der Vorschau der Suchergebnisse angewendet.
- Bereinigen: Der Filter wird beim Bereinigen von Suchergebnissen angewendet. Wie die Elemente gelöscht werden, wird durch den PurgeType-Parameterwert im cmdlet New-ComplianceSearchAction gesteuert. Der Standardwert ist SoftDelete. Dies bedeutet, dass die gelöschten Elemente von Benutzern wiederhergestellt werden können, bis der Aufbewahrungszeitraum für gelöschte Elemente abläuft.
- Suche: Der Filter wird beim Ausführen einer Suche angewendet.
- Search: Der Filter wird beim Ausführen einer Suche angewendet.
| Type: | ComplianceSecurityFilterActionType |
| 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 |
-Description
Der Parameter Description gibt eine Beschreibung für den Compliancesicherheitsfilter an. Die Höchstlänge beträgt 256 Zeichen. 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 |
-FilterName
Der Parameter FilterName gibt den Namen des Compliance-Sicherheitsfilters an, den Sie ändern möchten. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-Filters
Der Parameter Filters gibt die Suchkriterien für den Compliance-Sicherheitsfilter an. Sie können drei unterschiedliche Filtertypen erstellen:
- Mailbox filter: Gibt die Postfächer an, die von den zugewiesenen Benutzern durchsucht werden können. Gültige Syntax ist
Mailbox_<MailboxPropertyName>, wobei<MailboxPropertyName>ein Postfacheigenschaftswert ist. Ermöglicht benutzern beispielsweise, nur Postfächer zu durchsuchen,"Mailbox_CustomAttribute10 -eq 'OttawaUsers'"die den Wert OttawaUsers in der CustomAttribute10-Eigenschaft haben. Eine Liste der unterstützten Postfacheigenschaften finden Sie unter Filterbare Eigenschaften für den RecipientFilter-Parameter. - Postfachinhaltsfilter: Gibt den Postfachinhalt an, nach dem die zugewiesenen Benutzer suchen können. Gültige Syntax ist
MailboxContent_<SearchablePropertyName>, wobei<SearchablePropertyName>eine KQL-Eigenschaft (Keyword Query Language) angibt, die in einer Konformitätssuche angegeben werden kann. Ermöglicht benutzern beispielsweise, nur nach Nachrichten zu suchen,"MailboxContent_Recipients -like 'contoso.com'"die an Empfänger in der contoso.com Domäne gesendet wurden. Eine Liste der durchsuchbaren E-Mail-Eigenschaften finden Sie unter Schlüsselwortabfragen für eDiscovery. - Website- und Websiteinhaltsfilter: Es gibt zwei SharePoint Online- und OneDrive for Business websitebezogene Filter, die Sie erstellen können:
Site_<SearchableSiteProperty>(gibt websitebezogene Eigenschaften an. Ermöglicht benutzern beispielsweise,"Site_Path -eq 'https://contoso.sharepoint.com/sites/doctors'"nur nach Inhalten in derhttps://contoso.sharepoint.com/sites/doctorsWebsitesammlung zu suchen) undSiteContent_<SearchableSiteProperty>(gibt inhaltsbezogene Eigenschaften an. Ermöglicht benutzern beispielsweise,"SiteContent_FileExtension -eq 'docx'"nur nach Word-Dokumenten zu suchen). Eine Liste der durchsuchbaren Websiteeigenschaften finden Sie unter Übersicht über durchforstete und verwaltete Eigenschaften in SharePoint Server. Eigenschaften, die in der Spalte Abfragbar mit Ja gekennzeichnet sind, können zum Erstellen einer Website oder eines Websiteinhaltsfilters verwendet werden.
Sie können mehrere Filter desselben Typs angeben. Beispiel: "Mailbox_CustomAttribute10 -eq 'FTE' -and Mailbox_MemberOfGroup -eq '$($DG.DistinguishedName)'".
| Type: | MultiValuedProperty |
| 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 |
-Region
Der Parameter Region gibt den Satellitenstandort für Multi-Geo-Mandanten an, in dem eDiscovery-Suchen durchgeführt werden sollen. Gültige Werte sind:
- APC: Asia-Pacific
- AUS: Australien
- CAN: Kanada
- EUR: Europa, Naher Osten, Afrika
- FRA: Frankreich
- GBR: Vereinigtes Königreich
- IND: Indien
- JPN: Japan
- LAM: Lateinamerika
- NAM: Nordamerika
Wenn Sie diesen Parameter nicht in einem Multi-Geo-Mandanten verwenden, werden eDiscovery-Suchvorgänge am zentralen Ort durchgeführt.
| 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 |
-Users
Der Parameter Users gibt den Benutzer an, auf dessen Suchvorgänge dieser Filter angewendet wird. Gültige Werte sind:
- Mindestens ein Benutzer: Identifizieren Sie Benutzer anhand ihres Alias oder ihrer E-Mail-Adresse. Es können mehrere Werte durch Kommata getrennt angegeben werden.
- Der Wert „All“: Weist den Filter allen Benutzern zu. Dieser Wert kann nur alleine verwendet werden.
- One or more role groups: Identifiziert die Rollengruppe anhand ihres Namens. Es können mehrere Werte durch Kommata getrennt angegeben werden.
Sie können mit diesem Parameter keine Verteilergruppen angeben.
Die Werte, die Sie angeben, überschreiben vorhandene Einträge. Im Abschnitt „Beispiele“ erfahren Sie, wie Sie Benutzer ohne Beeinträchtigung vorhandener Einträge hinzufügen oder entfernen.
| Type: | MultiValuedProperty |
| 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 |
-WhatIf
Der WhatIf-Schalter funktioniert in PowerShell für Sicherheitskonformität & nicht.
| 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 |
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für