Freigeben über

Set-ComplianceSecurityFilter

  • Referenz
Modul:
ExchangePowerShell
Gilt für::
Exchange Server 2016, Exchange Server 2019, Security & Compliance

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.users

In 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.users

In 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 der https://contoso.sharepoint.com/sites/doctors Websitesammlung zu suchen) und SiteContent_<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