Set-RetentionPolicy

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2017-10-04

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet Set-RetentionPolicy permet de modifier les propriétés d’une stratégie de rétention existante.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Set-RetentionPolicy -Identity <MailboxPolicyIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-IsDefault <SwitchParameter>] [-IsDefaultArbitrationMailbox <SwitchParameter>] [-Name <String>] [-RetentionId <Guid>] [-RetentionPolicyTagLinks <RetentionPolicyTagIdParameter[]>] [-WhatIf [<SwitchParameter>]]

Cet exemple modifie la stratégie MyPolicy pour lier la balise de stratégie de rétention MyRetentionPolicyTag avec elle.

Set-RetentionPolicy "MyPolicy" -RetentionPolicyTagLinks "MyRetentionPolicyTag"
noteRemarque :
Le paramètre Identity est un paramètre positionnel. Les paramètres de position peuvent être utilisés sans l’étiquette (Identité). Pour plus d’informations sur les paramètres de position, consultez la rubrique Paramètres.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir Entrée « Gestion des enregistrements de messagerie » dans la rubrique Stratégie de messagerie et autorisations de conformité dans Exchange 2016.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxPolicyIdParameter

Le paramètre Identity spécifie le nom, le nom unique (DN) ou le GUID de la stratégie de rétention.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm 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 cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets 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.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

Force

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Force remplace la boîte de dialogue de confirmation affichée par la cmdlet lorsque vous utilisez le paramètre RetentionId.

IsDefault

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est réservé à l’usage interne chez Microsoft.

IsDefaultArbitrationMailbox

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est disponible uniquement dans le service informatique.

Le commutateur IsDefaultArbitrationMailbox configure cette stratégie comme la stratégie de rétention par défaut pour les boîtes aux lettres d’arbitrage dans votre organisation Exchange Online.

noteRemarque :
Ce paramètre n’est pas disponible dans les déploiements sur site.

Name

Facultatif

System.String

Le paramètre Name spécifie un nom unique pour la stratégie de rétention.

RetentionId

Facultatif

System.Guid

Le paramètre RetentionId spécifie l’identité de la stratégie de rétention pour garantir que les boîtes aux lettres transférées entre les deux organisations Exchange continuent d’avoir la même stratégie de rétention qui leur est appliquée. Par exemple, dans un déploiement inter-forêts ou intersites, lorsqu’une boîte aux lettres est déplacée d’un serveur Exchange sur site vers le nuage ou lorsqu’une boîte aux lettres informatique est déplacée vers un serveur Exchange sur site, ce paramètre permet de s’assurer que la même stratégie de rétention est appliquée à la boîte aux lettres.

importantImportant :
Il n’est généralement pas obligatoire de spécifier ou de modifier le paramètre RetentionId pour une balise de rétention. Ce paramètre est rempli automatiquement lors de l’importation des balises de rétention à l’aide du script Import-RetentionTags.ps1.

RetentionPolicyTagLinks

Facultatif

Microsoft.Exchange.Configuration.Tasks.RetentionPolicyTagIdParameter[]

Le paramètre RetentionPolicyTagLinks spécifie l’identité des balises de stratégie de rétention à associer à la stratégie de rétention. Les boîtes aux lettres sur lesquelles est appliquée une stratégie de conservation contiennent des balises de rétention liées à cette stratégie de rétention.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: