Get-ComplianceSecurityFilter
Cette applet de commande est fonctionnelle uniquement dans Security & Compliance PowerShell. 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 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 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 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.
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é
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-*) comportent 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.
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 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.
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
Applicable : Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Sécurité & Conformité
Le commutateur WhatIf ne fonctionne pas dans le Centre de sécurité et de conformité PowerShell.
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 courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.