Get-ComplianceSecurityFilter
Cette applet de commande est fonctionnelle uniquement dans PowerShell de conformité de la sécurité & . Pour plus d’informations, consultez Conformité de la sécurité & PowerShell.
Utilisez l’applet de commande Get-ComplianceSecurityFilter pour afficher les filtres de sécurité de conformité dans le portail de conformité Microsoft Purview. Ces filtres permettent aux utilisateurs spécifiés de rechercher uniquement un sous-ensemble de boîtes aux lettres et de sites SharePoint Online ou OneDrive Entreprise dans votre organization Microsoft 365.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
Get-ComplianceSecurityFilter
[-Action <ComplianceSecurityFilterActionType>]
[-Confirm]
[-FilterName <String>]
[-User <String>]
[-WhatIf]
[<CommonParameters>] Description
Les filtres de sécurité de conformité fonctionnent avec les recherches de conformité dans les portail de conformité Microsoft Purview (applets de commande*-ComplianceSearch), et non In-Place les recherches eDiscovery dans Exchange Online (applets de commande *-MailboxSearch).
Pour utiliser cette applet de commande dans PowerShell de conformité de la sécurité & , des autorisations doivent vous être attribuées. Pour plus d’informations, consultez la rubrique Autorisations dans le portail de conformité Microsoft Purview.
Exemples
Exemple 1
Get-ComplianceSecurityFilter | Format-Table -Auto FilterName,ActionCet exemple renvoie la liste récapitulative de tous les filtres de sécurité de la conformité.
Exemple 2
Get-ComplianceSecurityFilter -FilterName "HR Filter"Cet exemple renvoie des informations détaillées sur le filtre de sécurité de la conformité nommé HR Filter.
Paramètres
-Action
Le paramètre Action filtre les résultats en fonction du type d’action de recherche auquel un filtre est appliqué. Les valeurs valides sont les suivantes :
- Exporter : le filtre est appliqué lors de l’exportation des résultats de recherche ou de leur préparation pour analyse dans eDiscovery Premium.
- Aperçu : le filtre est appliqué lors de l’aperçu des résultats de la recherche.
- Vidage : le filtre est appliqué lors de la purge des résultats de recherche. La façon dont les éléments sont supprimés est contrôlée par la valeur du paramètre PurgeType sur l’applet de commande New-ComplianceSearchAction. La valeur par défaut est SoftDelete, ce qui signifie que les éléments vidés peuvent être récupérés par les utilisateurs jusqu’à l’expiration de la période de rétention des éléments supprimés.
- Recherche : le filtre est appliqué lors de l’exécution d’une recherche.
- Search : le filtre est appliqué lors de l’exécution d’une recherche.
| 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
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
| 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 |
-FilterName
Le paramètre FilterName permet de définir le nom du filtre de sécurité de la conformité que vous voulez utiliser. Si la valeur contient des espaces, placez-la entre guillemets (").
| 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 |
-User
Le paramètre User filtre les résultats par l’utilisateur qui obtient un filtre appliqué à ses recherches. Les valeurs valides sont les suivantes :
- L’alias ou l’adresse électronique d’un utilisateur.
- La valeur All.
- Le nom d’un groupe de rôles.
| 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 |
-WhatIf
Le commutateur WhatIf ne fonctionne pas dans PowerShell conformité de la sécurité & .
| 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 |