Get-ComplianceSecurityFilter

Dieses Cmdlet funktioniert nur in Security & Compliance PowerShell. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.

Verwenden Sie das Cmdlet Get-ComplianceSecurityFilter, um Compliance-Sicherheitsfilter im Microsoft Purview-Complianceportal anzuzeigen. Diese Filter ermöglichen es angegebenen Benutzern, nur eine Teilmenge der Postfächer und SharePoint- oder OneDrive-Websites in Ihrer Microsoft 365-Organization zu durchsuchen.

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

Syntax

Default (Standard)

Get-ComplianceSecurityFilter
    [-Action <ComplianceSecurityFilterActionType>]
    [-Confirm]
    [-FilterName <String>]
    [-User <String>]
    [-WhatIf]
    [<CommonParameters>]

Beschreibung

Compliance-Sicherheitsfilter funktionieren mit Compliancesuchen im Microsoft Purview-Complianceportal (*-ComplianceSearch-Cmdlets), nicht In-Place eDiscovery-Suchvorgängen in Exchange Online (*-MailboxSearch-Cmdlets).

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-ComplianceSecurityFilter | Format-Table -Auto FilterName,Action

In diesem Beispiel wird eine Übersichtsliste mit allen Compliance-Sicherheitsfiltern zurückgegeben.

Beispiel 2

Get-ComplianceSecurityFilter -FilterName "HR Filter"

In diesem Beispiel werden detaillierte Informationen über den Compliance-Sicherheitsfilter „HR Filter“ zurückgegeben.

Parameter

-Action

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

Der Action-Parameter filtert die Ergebnisse nach dem Typ der Suchaktion, auf die ein Filter angewendet wird. Gültige Werte sind:

  • Exportieren: Der Filter wird beim Exportieren von Suchergebnissen oder beim Vorbereiten der Analyse in eDiscovery Premium angewendet.
  • Vorschau: Der Filter wird bei der Vorschau der Suchergebnisse angewendet.
  • Bereinigen: Der Filter wird beim Löschen von Suchergebnissen angewendet. Wie die Elemente gelöscht werden, wird durch den PurgeType-Parameterwert im New-ComplianceSearchAction Cmdlet gesteuert. Der Standardwert ist "SoftDelete", d. h. die gelöschten Elemente können von Benutzern wiederhergestellt werden, bis der Aufbewahrungszeitraum für gelöschte Elemente abgelaufen ist.
  • Suche: Der Filter wird beim Ausführen einer Suche angewendet.
  • Search: Der Filter wird beim Ausführen einer Suche angewendet.

Parametereigenschaften

Typ:ComplianceSecurityFilterActionType
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

-Confirm

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

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FilterName

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

Der Parameter FilterName gibt den Namen des Compliance-Sicherheitsfilter an, den Sie anzeigen möchten. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

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

-User

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

Der Parameter "Benutzer" filtert die Ergebnisse nach dem Benutzer, dem ein Filter auf seine Suchvorgänge angewendet wird. Gültige Werte sind:

  • Der Alias oder die E-Mail-Adresse eines Benutzers.
  • Der Wert All.
  • Der Name einer Rollengruppe.

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

-WhatIf

Der WhatIf-Schalter funktioniert in Security & Compliance PowerShell nicht.

Der Schalter "WhatIf" zeigt die Funktion des Befehls an, ohne Änderungen vorzunehmen. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

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.