Set-EmailAddressPolicy (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2008-05-07
La cmdlet Set-EmailAddressPolicy permet de définir les attributs de service d'annuaire Active Directory pour une stratégie d'adresse de messagerie.
Syntaxe
Set-EmailAddressPolicy -Identity <EmailAddressPolicyIdParameter> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>]
Set-EmailAddressPolicy [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <EmailAddressPolicy>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>]
Description détaillée
La cmdlet Set-EmailAddressPolicy permet aux administrateurs de définir la plupart les attributs Active Directory pour une stratégie d'adresse de messagerie spécifique. La cmdlet Set-EmailAddressPolicy n'applique cependant pas les modifications à la stratégie d'adresse de messagerie. Utilisez la cmdlet Update-EmailAddressPolicy à la suite d'une cmdlet Set-EmailAddressPolicy pour appliquer les modifications.
Pour exécuter la cmdlet Set-EmailAddressPolicy, vous devez utiliser un compte auquel a été délégué :
- le rôle Administrateur d'organisation Exchange.
Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.
Pour plus d'informations sur la cmdlet Update-EmailAddressPolicy, consultez la rubrique Update-EmailAddressPolicy (RTM).
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter |
Le paramètre Identity permet de spécifier le GUID, le nom unique ou le nom de stratégie d'adresse de messagerie représentant une stratégie d'adresse de messagerie spécifique. Vous pouvez également inclure le chemin d'accès en utilisant le format Chemin\Stratégie_adresse_de_messagerie. Vous pouvez omettre l'étiquette de paramètre Identity de façon à ne fournir que le nom de stratégie d'adresse de messagerie ou le GUID. |
ConditionalCompany |
Facultatif |
Microsoft.Exchange.Data.MultiValuedProperty |
Le paramètre ConditionalCompany définit la société pour la stratégie d'adresse de messagerie. Il prend plusieurs valeurs sous forme de liste délimitée par des virgules. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute1 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute1 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute10 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute10 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute11 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute11 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute12 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute12 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute13 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute13 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute14 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute14 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute15 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute15 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute2 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute2 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute3 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute3 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute4 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute4 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute5 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute5 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute6 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute6 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute7 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute7 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute8 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute8 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalCustomAttribute9 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute9 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalDepartment |
Facultatif |
Microsoft.Exchange.Data.MultiValuedProperty |
Le paramètre ConditionalDepartment définit le département pour la stratégie d'adresse de messagerie. Il prend plusieurs valeurs sous forme de liste délimitée par des virgules. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
ConditionalStateOrProvince |
Facultatif |
Microsoft.Exchange.Data.MultiValuedProperty |
Le paramètre ConditionalStateOrProvince définit l'état ou la province pour la stratégie d'adresse de messagerie. Il prend plusieurs valeurs sous forme de liste délimitée par des virgules. Vous devez utiliser le paramètre IncludedRecipients si vous utilisez un paramètre Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
DisabledEmailAddressTemplates |
Facultatif |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
Le paramètre DisabledEmailAddressTemplates définit les adresses proxy incluses dans une stratégie d'adresse de messagerie et désactivées. Il prend plusieurs valeurs sous forme de liste délimitée par des virgules. |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui extrait des données depuis Active Directory, incluez le paramètre DomainController dans la commande. |
EnabledEmailAddressTemplates |
Facultatif |
Microsoft.Exchange.Data.ProxyAddressTemplateCollection |
Le paramètre EnabledEmailAddressTemplates définit les adresses proxy incluses dans une stratégie d'adresse de messagerie et activées. Il prend plusieurs valeurs sous forme de liste délimitée par des virgules. |
EnabledPrimarySMTPAddressTemplate |
Facultatif |
System.String |
Le paramètre EnabledPrimarySMTPAddressTemplate spécifie les adresses proxy incluses dans une stratégie d'adresse de messagerie et activées. Il prend plusieurs valeurs sous forme de liste délimitée par des virgules. |
ForceUpgrade |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre ForceUpgrade supprime la confirmation suivante : « Pour enregistrer les modifications apportées à l'objet, ce dernier doit être mis à niveau vers la version actuelle d'Exchange. Après la mise à niveau, cet objet ne pourra plus être géré par une version antérieure du Gestionnaire système Exchange. Voulez-vous continuer la mise à niveau et enregistrer l'objet ? » Cette confirmation s'affiche lors que vous mettez à niveau une stratégie d'adresse de messagerie créée dans Microsoft Exchange Server 2003 ou Exchange 2000 Server. Vous ne pouvez pas gérer une stratégie d'adresse de messagerie Exchange 2003 ou Exchange 2000 à l'aide de la console de gestion Exchange tant que vous n'avez pas mis à jour la version de l'objet et modifié le filtre des destinataires à l'aide des paramètres RecipientFilter ou IncludedRecipients. |
IncludedRecipients |
Facultatif |
System.Nullable |
Le paramètre IncludedRecipients filtre les types de destinataires qui sont utilisés pour créer la liste d'adresses globale (LAG). Les valeurs disponibles pour le paramètre IncludedRecipients sont AllRecipients, MailboxUsers, Resources, Contacts et MailGroups. La valeur AllRecipients ne peut être utilisée qu'isolément. Lorsque plusieurs valeurs du paramètre IncludedRecipients sont séparées par des virgules, l'opérateur booléen OR est appliqué. Vous devez utiliser ce paramètre si vous utilisez l'un des paramètres Conditional. Vous ne pouvez pas utiliser ce paramètre si vous utilisez le paramètre RecipientFilter. |
Instance |
Facultatif |
Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicy |
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. |
Name |
Facultatif |
System.String |
Le paramètre Name définit le nouveau nom de la stratégie d'adresse de messagerie. |
Priority |
Facultatif |
Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority |
Le paramètre Priority élève la priorité actuelle par rapport à celle spécifiée comme argument pour ce paramètre. |
RecipientFilter |
Facultatif |
System.String |
Le paramètre RecipientFilter filtre les destinataires contenus dans une stratégie d'adresse de messagerie particulière. Vous ne pouvez pas utiliser le paramètre RecipientFilter si l'un des paramètres suivants est spécifié :
Pour plus d'informations sur les propriétés filtrables, consultez la rubrique Propriétés filtrables pour le paramètre -RecipientFilter. |
Types d'entrées
Types de retours
Erreurs
Erreur | Description |
---|---|
Exceptions
Exceptions | Description |
---|---|
Exemple
Le code suivant est un exemple de la commande Set-EmailAddressPolicy dans laquelle le nom de la stratégie d'adresse de messagerie EMAIL_ADDRESS_POLICY01 à EMAILADDRESSPOLICY02 est modifié.
Set-EmailAddressPolicy -Identity EMAIL_ADDRESS_POLICY01 -Name EMAIL_ADDRESS_POLICY02