Get-ComplianceSecurityFilter
Cette applet de commande est fonctionnelle uniquement dans le PowerShell Sécurité & Conformité. Si vous souhaitez en savoir plus, veuillez consulter l’article Centre de conformité et 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 ou OneDrive 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.
Syntaxe
Default (Par défaut)
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 le portail de conformité Microsoft Purview (applets de commande *-ComplianceSearch), et non In-Place les recherches eDiscovery dans Exchange Online (applets de commande *-MailboxSearch).
Pour pouvoir utiliser cette cmdlet dans le Centre de sécurité et de conformité PowerShell, 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,Action
Cet 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
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, sécurité & conformité
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 à des fins d’analyse dans eDiscovery Premium.
- Aperçu : le filtre est appliqué lors de la prévisualisation des résultats de recherche.
- Purger : le filtre est appliqué lors de la purge des résultats de recherche. La manière 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 purgés sont récupérables 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.
Propriétés du paramètre
| Type: | ComplianceSecurityFilterActionType |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, sécurité & conformité
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-FilterName
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, sécurité & conformité
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 (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-User
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, sécurité & conformité
Le paramètre User filtre les résultats en fonction de 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.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Le commutateur WhatIf ne fonctionne pas dans le Centre de sécurité et de conformité PowerShell.
Le commutateur WhatIf affiche ce que la commande fait sans apporter de modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.