New-EmailAddressPolicy (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-06-05
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 <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>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -RecipientFilter <String> [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -RecipientFilter <String> [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -IncludedRecipients <Nullable> [-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>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
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 :
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 |
System.String |
Le paramètre ConditionalCustomAttribute1 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute10 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute10 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute11 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute11 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute12 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute12 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute13 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute13 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute14 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute14 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute15 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute15 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute2 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute2 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute3 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute3 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute4 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute4 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute5 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute5 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute6 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute6 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute7 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute7 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute8 |
Facultatif |
System.String |
Le paramètre ConditionalCustomAttribute8 spécifie des attributs personnalisés. Vous pouvez les utiliser pour stocker des informations supplémentaires. |
ConditionalCustomAttribute9 |
Facultatif |
System.String |
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. |
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. |
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