Get-RetentionCompliancePolicy
Cette cmdlet est disponible uniquement dans le Centre de conformité et sécurité PowerShell. Si vous souhaitez en savoir plus, veuillez consulter l’article Centre de conformité et 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.
Syntaxe
Default (Par défaut)
Get-RetentionCompliancePolicy
[[-Identity] <PolicyIdParameter>]
[-DistributionDetail]
[-ErrorPolicyOnly]
[-ExcludeTeamsPolicy]
[-IncludeTestModeResults]
[-PriorityCleanup]
[-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 : actuellement, elle affiche toutes les charges de travail (Exchange, SharePoint, OneDriveForBusiness, Skype, ModernGroup). Il 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 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-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
Applicable : Sécurité & Conformité
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| 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 |
-ErrorPolicyOnly
Applicable : Sécurité & Conformité
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| 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 |
-ExcludeTeamsPolicy
Applicable : Sécurité & Conformité
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| 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 |
-Identity
Applicable : Sécurité & Conformité
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
Attention : la valeur $null ou une valeur inexistante pour le paramètre Identity retourne tous les objets comme si vous exécutiez la commande Get- sans le paramètre Identity. Vérifiez que les listes de valeurs du paramètre Identity sont exactes et ne contiennent pas de valeurs $null inexistantes.
Propriétés des paramètres
| Type: | PolicyIdParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-IncludeTestModeResults
Applicable : Sécurité & Conformité
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| 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 |
-PriorityCleanup
Applicable : Sécurité & Conformité
{{ Fill PriorityCleanup Description }}
Propriétés des paramètres
| Type: | SwitchParameter |
| 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 |
-RetentionRuleTypes
Applicable : Sécurité & Conformité
Le commutateur RetentionRuleTypes spécifie s’il faut retourner la valeur des propriétés RetentionRuleTypes et HasRules 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, les valeurs RetentionRuleTypes apparaissent vides et HasRules ont la valeur False.
Propriétés des paramètres
| Type: | SwitchParameter |
| 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 |
-TeamsPolicyOnly
Applicable : Sécurité & Conformité
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.
Propriétés des paramètres
| Type: | SwitchParameter |
| 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 |
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.