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.