Get-RetentionCompliancePolicy

  • Référence
Module:
ExchangePowerShell
S’applique à:
Security & Compliance

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