Set-PublicFolder

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2012-03-26

La cmdlet Set-PublicFolder permet de définir les attributs de dossiers publics.

Syntaxe

Set-PublicFolder -Identity <PublicFolderIdParameter> [-AgeLimit <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IssueWarningQuota <Unlimited>] [-MaxItemSize <Unlimited>] [-Name <String>] [-PerUserReadStateEnabled <$true | $false>] [-ProhibitPostQuota <Unlimited>] [-Replicas <DatabaseIdParameter[]>] [-ReplicationSchedule <Schedule>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-Server <ServerIdParameter>] [-UseDatabaseAgeDefaults <$true | $false>] [-UseDatabaseQuotaDefaults <$true | $false>] [-UseDatabaseReplicationSchedule <$true | $false>] [-UseDatabaseRetentionDefaults <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-PublicFolder -Identity <PublicFolderIdParameter> [-AgeLimit <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IssueWarningQuota <Unlimited>] [-LocalReplicaAgeLimit <EnhancedTimeSpan>] [-MaxItemSize <Unlimited>] [-Name <String>] [-PerUserReadStateEnabled <$true | $false>] [-ProhibitPostQuota <Unlimited>] [-Replicas <DatabaseIdParameter[]>] [-ReplicationSchedule <Schedule>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-Server <ServerIdParameter>] [-UseDatabaseAgeDefaults <$true | $false>] [-UseDatabaseQuotaDefaults <$true | $false>] [-UseDatabaseReplicationSchedule <$true | $false>] [-UseDatabaseRetentionDefaults <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-PublicFolder [-AgeLimit <EnhancedTimeSpan>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HiddenFromAddressListsEnabled <$true | $false>] [-Instance <PublicFolder>] [-IssueWarningQuota <Unlimited>] [-MaxItemSize <Unlimited>] [-Name <String>] [-PerUserReadStateEnabled <$true | $false>] [-ProhibitPostQuota <Unlimited>] [-Replicas <DatabaseIdParameter[]>] [-ReplicationSchedule <Schedule>] [-RetainDeletedItemsFor <EnhancedTimeSpan>] [-Server <ServerIdParameter>] [-UseDatabaseAgeDefaults <$true | $false>] [-UseDatabaseQuotaDefaults <$true | $false>] [-UseDatabaseReplicationSchedule <$true | $false>] [-UseDatabaseRetentionDefaults <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet Set-PublicFolder, vous devez utiliser un compte auquel a été délégué :

  • le rôle Administrateur de dossiers publics Exchange et le groupe Administrateurs local pour le serveur cible.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.PublicFolderIdParameter

Le paramètre Identity permet de spécifier le GUID ou le nom de dossier public représentant un dossier public spécifique. Vous pouvez également inclure le chemin d'accès en utilisant le format Dossier_public_niveau_supérieur\Dossier_public.

Vous pouvez omettre l'étiquette de paramètre Identity de façon à ne fournir que le nom de dossier public ou le GUID.

AgeLimit

Facultatif

Microsoft.Exchange.Data.EnhancedTimeSpan

Le paramètre AgeLimit spécifie la limite d'âge globale pour le dossier. Les réplicas de ce dossier public sont automatiquement supprimés lorsque la limite d'âge est dépassée. Ce paramètre est incompatible avec le paramètre UseDatabaseAgeDefaults.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Le paramètre DomainController spécifie le contrôleur de domaine à utiliser pour écrire cette modification de configuration dans Active Directory. Utilisez le nom de domaine complet (FQDN) du contrôleur de domaine que vous voulez utiliser.

HiddenFromAddressListsEnabled

Facultatif

System.Boolean

Le paramètre HiddenFromAddressListsEnabled spécifie le masquage ou non du dossier public dans les listes d'adresses.

Instance

Facultatif

Microsoft.Exchange.Data.Mapi.PublicFolder

Le paramètre Instance permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande.

IssueWarningQuota

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre IssueWarningQuota spécifie la taille du dossier public à laquelle un avertissement est émis à l'attention des propriétaires de dossier public pour les informer que le dossier est presque plein.

LocalReplicaAgeLimit

Facultatif

Microsoft.Exchange.Data.EnhancedTimeSpan

Le paramètre LocalReplicaAgeLimit spécifie la limite d'âge du réplica figurant éventuellement sur le serveur connecté. Pour supprimer la limite d'âge, définissez la valeur du paramètre sur « $null ».

MaxItemSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre MaxItemSize spécifie la taille maximale en kilo-octets (Ko) autorisée pour la publication d'un élément. Ce paramètre est incompatible avec le paramètre UseDatabaseQuotaDefaults.

Name

Facultatif

System.String

Le paramètre Name spécifie le nom du dossier public.

PerUserReadStateEnabled

Facultatif

System.Boolean

Le paramètre PerUserReadStateEnabled spécifie la conservation des données lues et non lues pour un utilisateur.

ProhibitPostQuota

Facultatif

Microsoft.Exchange.Data.Unlimited

Le paramètre ProhibitPostQuota spécifie la taille d'un dossier public à laquelle les utilisateurs sont avertis que le dossier public est plein. Les utilisateurs ne peuvent pas publier dans un dossier dont la taille est supérieure à la valeur du paramètre ProhibitPostQuota.

Replicas

Facultatif

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter[]

Le paramètre Replicas spécifie une liste de serveurs de boîtes aux lettres avec lesquels répliquer ce dossier public.

ReplicationSchedule

Facultatif

Microsoft.Exchange.Data.Schedule

Le paramètre ReplicationSchedule spécifie la planification de la réplication pour le dossier selon le format suivant :

Jour.Heure:Minute [AM/PM]-Jour.Heure:Minute [AM/PM].

Les jours peuvent être indiqués sous leur forme complète ou abrégés. Si vous préférez utiliser une horloge basée sur 24 heures, omettez les indications AM/PM. Vous pouvez mélanger les formats.

Exemple : Dim.1:15 AM-Lundi.23:00

Ce paramètre est incompatible avec le paramètre UseDatabaseReplicationSchedule.

RetainDeletedItemsFor

Facultatif

Microsoft.Exchange.Data.EnhancedTimeSpan

Le paramètre RetainDeletedItemsFor spécifie la durée de rétention des éléments supprimés. Ce paramètre est incompatible avec le paramètre UseDatabaseRetentionDefaults.

Server

Facultatif

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Le paramètre Server spécifie le serveur sur lequel exécuter les opérations sélectionnées.

UseDatabaseAgeDefaults

Facultatif

System.Boolean

Le paramètre UseDatabaseAgeDefaults spécifie d'utiliser la limite d'âge de base de données.

UseDatabaseQuotaDefaults

Facultatif

System.Boolean

Le paramètre UseDatabaseQuotaDefaults spécifie d'utiliser les limites de quota de banque publique.

UseDatabaseReplicationSchedule

Facultatif

System.Boolean

Le paramètre UseDatabaseReplicationSchedule spécifie la planification de la réplication du dossier public.

UseDatabaseRetentionDefaults

Facultatif

System.Boolean

Le paramètre UseDatabaseRetentionDefaults spécifie d'utiliser les valeurs par défaut de rétention de base de données.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Types d'entrées

Types de retours

Erreurs

Erreur Description

  

Exceptions

Exceptions Description

  

Exemple

Dans le premier exemple, la commande Set-PublicFolder permet de modifier un dossier public de façon à ce qu'il n'utilise pas la planification par défaut de la réplication de la base de données.

Dans le deuxième exemple, la commande Set-PublicFolder permet de définir la planification de la réplication sur Always (toujours).

Dans le troisième exemple, la commande Set-PublicFolder permet de planifier la réplication uniquement les week-ends.

Set-PublicFolder "\Customer Service Requests" -UseDatabaseReplicationSchedule $false
Set-PublicFolder "\Customer Service Requests" -ReplicationSchedule Always
Set-PublicFolder \MyPublicFolder -ReplicationSchedule "Saturday.12:00 AM-Monday.12:00 AM"

Tous les paramètres de la commande Set-PublicFolder peuvent accepter des entrées en pipeline comme argument et un type strong.

Lorsque vous définissez la valeur du paramètre UseDatabaseQuotaDefaults sur true, les valeurs suivantes reprennent leurs valeurs par défaut :

  • MaxItemSize

  • IssueWarningQuota

  • ProhibitPostQuota

ٍVous ne pouvez pas utiliser la cmdlet Set-PublicFolder pour modifier l'une des valeurs suivantes lorsque le paramètre UseDatabaseQuotaDefaults est défini sur true :

  • MaxItemSize

  • IssueWarningQuota

  • ProhibitPostQuota

En effet, ces valeurs ne sont pas applicables lorsque vous utilisez les quotas de base de données par défaut.

Dans Exchange Server 2007 Service Pack 2 (SP2), la valeur IssueWarningQuota doit être inférieure ou égale à la valeur ProhibitPostQuota. Par ailleurs, la valeur MaxItemSize doit être inférieure ou égale à la valeur ProhibitPostQuota.