New-EmailAddressPolicy

 

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

Dernière rubrique modifiée : 2009-05-12

La cmdlet New-EmailAddressPolicy permet de créer une stratégie d'adresse de messagerie.

Syntaxe

New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -IncludedRecipients <Nullable> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -RecipientFilter <String> [-Confirm [<SwitchParameter>]] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -RecipientFilter <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -IncludedRecipients <Nullable> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet New-EmailAddressPolicy crée une stratégie d'adresse de messagerie et l'applique. La stratégie d'adresse de messagerie est créée dans le conteneur de configuration de l'organisation Microsoft Exchange du service d'annuaire Active Directory.

Pour exécuter la cmdlet New-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 Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

EnabledEmailAddressTemplates

Obligatoire

Microsoft.Exchange.Data.ProxyAddressTemplateCollection

Le paramètre EnabledEmailAddressTemplates spécifie les adresses proxy incluses dans une stratégie d'adresse de messagerie et activées. Séparez les valeurs multiples à l'aide de virgules. La partie domaine de chaque adresse proxy doit correspondre à un domaine accepté existant.

EnabledPrimarySMTPAddressTemplate

Obligatoire

System.String

Le paramètre EnabledPrimarySMTPAddressTemplate spécifie l'adresse proxy activée et incluse dans une stratégie d'adresse de messagerie. La partie domaine de chaque adresse proxy doit correspondre à un domaine accepté existant.

IncludedRecipients

Obligatoire

System.Nullable

Le paramètre IncludedRecipients filtre les destinataires utilisés pour définir la stratégie d'adresse de messagerie. 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é.

Name

Obligatoire

System.String

Le paramètre Name définit le nom de la stratégie d'adresse de messagerie.

RecipientFilter

Obligatoire

System.String

Le paramètre RecipientFilter spécifie un filtre pour les destinataires à inclure dans la stratégie d'adresse de messagerie. Vous ne pouvez pas utiliser ce paramètre si vous utilisez l'un des paramètres de filtre suivants :

  • ConditionalCompany

  • ConditionalDepartment

  • IncludedRecipients

  • ConditionalStateOrProvince

Pour plus d'informations sur les propriétés filtrables, consultez la rubrique Propriétés filtrables pour le paramètre -RecipientFilter.

ConditionalCompany

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCompany filtre par société. Il prend plusieurs valeurs sous forme de liste délimitée par des virgules.

ConditionalCustomAttribute1

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute1 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute10

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute10 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute11

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute11 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute12

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute12 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute13

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute13 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute14

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute14 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute15

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute15 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute2

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute2 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute3

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute3 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute4

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute4 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute5

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute5 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute6

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute6 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute7

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute7 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute8

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute8 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalCustomAttribute9

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalCustomAttribute9 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires.

ConditionalDepartment

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalDepartment filtre par service. Il prend plusieurs valeurs sous forme de liste délimitée par des virgules.

ConditionalStateOrProvince

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre ConditionalStateOrProvince filtre par état ou département. Il prend plusieurs valeurs sous forme de liste délimitée par des virgules.

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.

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 écrit ce changement de configuration dans Active Directory, incluez le paramètre DomainController dans la commande.

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.

TemplateInstance

Facultatif

System.Management.Automation.PSObject

Lorsqu'un objet existant est fourni au paramètre TemplateInstance, la commande utilise la configuration de cet objet pour créer une copie de celui-ci sur un serveur local ou cible.

UseRusServer

Facultatif

System.String

> [!Note] > Ce paramètre n'est disponible que dans Exchange 2007 SP2.

Le paramètre UseRusServer indique à la commande d'utiliser le serveur de boîtes aux lettres spécifié sur lequel le service de listes d'adresses est exécuté pour obtenir puis définir les attributs des boîtes aux lettres et des utilisateurs Active Directory.

Le service de listes d'adresses est un composant du service Surveillance du système Exchange. Le service de listes d'adresses crée et gère les valeurs des attributs spécifiques d'Exchange dans Active Directory. Vous pouvez utiliser le service de listes d'adresses pour mettre à jour les objets destinataire dans un domaine à l'aide d'informations spécifiques telles que l'appartenance à une liste d'adresses et des adresses de messagerie.

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

L'exemple de code suivant illustre la commande New-EmailAddressPolicy.

New-EmailAddressPolicy -Name "MyPolicy" -IncludedRecipients MailboxUsers -EnabledPrimarySMTPAddressTemplate SMTP:@contoso.com