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