Get-ComplianceSecurityFilter

Dieses Cmdlet ist nur in Security & Compliance PowerShell funktionsfähig. Weitere Informationen finden Sie unter Security & Compliance Center-PowerShell.

Verwenden Sie das Cmdlet Get-ComplianceSecurityFilter, um Konformitätssicherheitsfilter im Microsoft Purview-Complianceportal anzuzeigen. Diese Filter ermöglichen es angegebenen Benutzern, nur eine Teilmenge von Postfächern und SharePoint- oder OneDrive-Websites in Ihrem 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

Compliancesicherheitsfilter funktionieren mit Konformitätssuchen in den Microsoft Purview-Complianceportal (*-ComplianceSearch-Cmdlets), nicht In-Place eDiscovery-Suchen 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 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.

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:Cf

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 User filtert die Ergebnisse nach dem Benutzer, der einen Filter erhält, der 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.

Die WhatIf-Option zeigt an, was der Befehl tut, 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.