Get-RetentionCompliancePolicy
Cette applet de commande est disponible uniquement dans & Security Compliance PowerShell. Pour plus d’informations, consultez Conformité de la sécurité & PowerShell.
Utilisez le Get-RetentionCompliancePolicy pour afficher les stratégies de rétention existantes dans le portail de conformité Microsoft Purview.
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-RetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-ExcludeTeamsPolicy]
[-IncludeTestModeResults]
[-RetentionRuleTypes]
[-TeamsPolicyOnly]
[<CommonParameters>]
Description
Cette liste décrit les propriétés affichées par défaut.
- Name : nom unique de la stratégie.
- Charge de travail : pour le moment, elle affiche toutes les charges de travail (Exchange, SharePoint, OneDriveForBusiness, Skype, ModernGroup) et n’affiche pas la charge de travail réelle sur laquelle la stratégie est appliquée.
- Enabled : la valeur True indique que la stratégie est activée.
- Mode : Mode de fonctionnement actuel de la stratégie. Les valeurs possibles sont Test (le contenu est testé, mais aucune règle n’est appliquée), AuditAndNotify (lorsque le contenu correspond aux conditions spécifiées par la stratégie, la règle n’est pas appliquée, mais les e-mails de notification sont envoyés) ou Appliquer (tous les aspects de la stratégie sont activés et appliqués).
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-RetentionCompliancePolicy
Cet exemple affiche des informations récapitulatives pour toutes les stratégies de rétention de votre organisation.
Exemple 2
Get-RetentionCompliancePolicy -Identity "Regulation 123 Compliance" -DistributionDetail | Format-List
Cet exemple permet d’afficher des informations détaillées pour la stratégie nommée « Regulation 123 Compliance », y compris des valeurs précises pour les propriétés DistributionStatus et *Location.
Paramètres
-DistributionDetail
Le commutateur DistributionDetail renvoie des informations de distribution de stratégie détaillées dans la propriété DistributionResults. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Si vous n’utilisez pas ce commutateur, les valeurs de propriété DistributionStatus et *Location seront inexactes.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ErrorPolicyOnly
Le commutateur ErrorPolicyOnly spécifie s’il faut afficher uniquement les stratégies qui présentent des erreurs de distribution dans les résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ExcludeTeamsPolicy
Le commutateur ExcludeTeamsPolicy spécifie s’il faut exclure les stratégies Teams des résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Identity
Le paramètre Identity permet de définir la stratégie de rétention à afficher. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la stratégie. Par exemple :
- Nom
- Nom unique (DN)
- GUID
Type: | PolicyIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-IncludeTestModeResults
Le commutateur IncludeTestModeResults spécifie s’il faut inclure le status du mode test dans les détails de la stratégie. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Pour plus d'informations sur le mode simulation, voir En savoir plus sur le mode simulation.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RetentionRuleTypes
Le commutateur RetentionRuleTypes spécifie s’il faut retourner la valeur de la propriété RetentionRuleTypes dans les résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Pour afficher la propriété RetentionRuleTypes, vous devez associer la commande à une cmdlet de mise en forme. Par exemple : Get-RetentionCompliancePolicy -RetentionRuleTypes | Format-Table -Auto Name,RetentionRuleTypes
. Si vous n’utilisez pas le commutateur RetentionRuleTypes, la valeur est vide.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-TeamsPolicyOnly
Le commutateur TeamsPolicyOnly spécifie s’il faut afficher uniquement les stratégies Teams dans les résultats. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |