Partager via


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é :

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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