New-EmailAddressPolicy

Module:: Exchange PowerShell

Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres et réglages peuvent être exclusifs à l’un ou l’autre environnement.

La cmdlet New-EmailAddressPolicy permet de créer des stratégies d’adresse de messagerie. Dans Exchange Online, les stratégies d’adresse e-mail sont disponibles uniquement pour les groupes Microsoft 365.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntaxe

AllTemplatesWithPrecannedFilter

New-EmailAddressPolicy
    [-Name] <String>
    -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
    -IncludedRecipients <WellKnownRecipientType>
    [-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]
    [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
    [-DomainController <Fqdn>]
    [-Priority <EmailAddressPolicyPriority>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

AllTemplatesWithCustomFilter

New-EmailAddressPolicy
    [-Name] <String>
    -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
    -RecipientFilter <String>
    [-Confirm]
    [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
    [-DomainController <Fqdn>]
    [-Priority <EmailAddressPolicyPriority>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

SMTPTemplateWithPrecannedFilter

New-EmailAddressPolicy
    [-Name] <String>
    -EnabledPrimarySMTPAddressTemplate <String>
    -IncludedRecipients <WellKnownRecipientType>
    [-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]
    [-DomainController <Fqdn>]
    [-Priority <EmailAddressPolicyPriority>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

SMTPTemplateWithCustomFilter

New-EmailAddressPolicy
    [-Name] <String>
    -EnabledPrimarySMTPAddressTemplate <String>
    -RecipientFilter <String>
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Priority <EmailAddressPolicyPriority>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

AllTemplatesForUnifiedGroupRecipientsFilter

New-EmailAddressPolicy
    [-Name] <String>
    -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
    [-IncludeUnifiedGroupRecipients]
    [-ManagedByFilter <String>]
    [-Confirm]
    [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
    [-DomainController <Fqdn>]
    [-Priority <EmailAddressPolicyPriority>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

SMTPTemplateForUnifiedGroupRecipientsFilter

New-EmailAddressPolicy
    [-Name] <String>
    -EnabledPrimarySMTPAddressTemplate <String>
    [-IncludeUnifiedGroupRecipients]
    [-ManagedByFilter <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Priority <EmailAddressPolicyPriority>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-WhatIf]
    [<CommonParameters>]

Description

Après avoir utilisé l’applet de commande New-EmailAddressPolicy pour créer une stratégie d’adresse e-mail dans un organization Exchange local, vous devez utiliser l’applet de commande Update-EmailAddressPolicy pour appliquer la nouvelle stratégie aux destinataires.

Les paramètres Conditional qui sont utilisés avec le paramètre IncludedRecipients sont soumis aux limitations suivantes :

L’opérateur EQV est utilisé pour chaque valeur de propriété, comme dans « service est égal à ventes ». Les caractères génériques et les correspondances partielles ne sont pas pris en charge.
L’opérateur OR est toujours utilisé pour plusieurs valeurs de la même propriété, comme dans « service est égal à ventes OR marketing ».
L’opérateur AND est toujours utilisé pour plusieurs propriétés, comme dans « service est égal à ventes AND société est égal à Contoso ».

Pour créer des filtres flexibles qui utilisent n’importe quelle propriété de destinataire disponible et qui ne sont pas soumis à ces limitations, vous pouvez utiliser le paramètre RecipientFilter pour créer un filtre OPATH.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

New-EmailAddressPolicy -Name "Southeast Offices" -IncludedRecipients MailboxUsers -ConditionalStateorProvince "GA","AL","LA" -EnabledEmailAddressTemplates "SMTP:%s%2g@southeast.contoso.com","smtp:%s%2g@southeast.contoso.net"

Cet exemple crée une stratégie d’adresse e-mail dans une organisation Exchange locale qui utilise un filtre de destinataire prédéfini :

Nom : Bureaux du Sud-Est
Filtre de destinataire prédéfini : tous les utilisateurs dont la boîte aux lettres dont la valeur État ou province est GA, AL ou LA (Géorgie, Alabama ou Louisiane).
Adresse e-mail SMTP principale : <last name>.<first two letters of the first name>@contoso.com
Adresses e-mail proxy supplémentaires : <last name>.<first two letters of the first name>@contoso.net
Priorité : N+1, où N correspond au nombre de stratégies d’adresse de messagerie créées manuellement qui existent déjà (nous n’avons pas utilisé le paramètre Priorité et la valeur par défaut est N +1).

Exemple 2

New-EmailAddressPolicy -Name "Northwest Executives" -RecipientFilter "(RecipientTypeDetails -eq 'UserMailbox') -and (Title -like '*Director*' -or Title -like '*Manager*') -and (StateOrProvince -eq 'WA' -or StateOrProvince -eq 'OR' -or StateOrProvince -eq 'ID')" -EnabledEmailAddressTemplates "SMTP:%2g%s@contoso.com" -Priority 2

Cet exemple crée une stratégie d’adresse e-mail dans une organisation Exchange locale qui utilise un filtre de destinataire personnalisé :

Nom : Northwest Executives
Filtre de destinataire personnalisé : tous les utilisateurs dont la boîte aux lettres contient Director ou Manager, et la valeur State or province est WA, OR ou ID (Washington, Oregon ou Idaho).
Adresse e-mail SMTP principale : <first two letters of the first name><last name>@contoso.com
Adresses e-mail proxy supplémentaires : aucune
Priorité : 2

Paramètres

-ConditionalCompany

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCompany spécifie un filtre prédéfini basé sur la valeur de la propriété Company du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Lorsque vous utilisez plusieurs valeurs pour ce paramètre, l’opérateur booléen OU est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cet article.

Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre prédéfini. Vous ne pouvez pas utiliser de paramètres conditionnels en combinaison avec le paramètre RecipientFilter (qui est utilisé pour créer des filtres OPATH personnalisés).

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute1

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute1 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute1 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute10

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute10 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute10 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute11

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute11 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute11 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute12

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute12 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute12 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute13

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute13 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute13 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute14

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute14 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute14 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute15

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute15 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute15 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute2

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute2 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute2 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute3

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute3 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute3 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute4

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute4 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute4 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute5

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute5 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute5 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute6

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute6 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute6 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute7

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute7 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute7 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute8

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute8 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute8 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalCustomAttribute9

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalCustomAttribute9 spécifie un filtre prédéfini basé sur la valeur de la propriété CustomAttribute9 du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalDepartment

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalDepartment spécifie un filtre prédéfini basé sur la valeur de la propriété Department du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ConditionalStateOrProvince

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre ConditionalStateOrProvince spécifie un filtre prédéfini basé sur la valeur de la propriété StateOrProvince du destinataire. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Propriétés du paramètre

Type:	MultiValuedProperty
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Confirm

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’impact de ce commutateur sur l’applet de commande varie selon que l’applet de commande nécessite une confirmation avant de continuer.

Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces applets de commande, la spécification du commutateur Confirmer sans valeur introduit une pause qui vous oblige à accuser réception de la commande avant de continuer.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DisabledEmailAddressTemplates

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre DisabledEmailAddressTemplates spécifie les modèles d’adresses e-mail proxy qui sont inclus dans une stratégie d’adresse e-mail, mais qui ne sont pas utilisés pour configurer les adresses e-mail des destinataires.

La syntaxe valide pour ce paramètre est la suivante Type:AddressFormat:

Type : type d’adresse de messagerie valide tel que décrit dans la section « Types d’adresses » de Email stratégies d’adresse dans Exchange Server. Par exemple, smtp ou X400. Vous ne pouvez pas utiliser SMTP pour spécifier une adresse e-mail SMTP principale désactivée.
AddressFormat : pour les adresses e-mail SMTP, un domaine ou un sous-domaine configuré en tant que domaine accepté (faisant autorité ou relais interne), ainsi que des variables valides et des caractères de texte ASCII, comme décrit dans la section « Formats d’adresse » de la rubrique Email stratégies d’adresse dans Exchange Server. Par exemple : alias@contoso.com nécessite la valeur %m@contoso.com, et firstname.lastname@contoso.com exige la valeur %g.%s@contoso.com.

Vous pouvez spécifier plusieurs modèles d’adresses e-mail désactivées séparées par des virgules : "[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN".

Propriétés du paramètre

Type:	ProxyAddressTemplateCollection
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

AllTemplatesWithCustomFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

AllTemplatesForUnifiedGroupRecipientsFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-DomainController

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».

Propriétés du paramètre

Type:	Fqdn
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-EnabledEmailAddressTemplates

Pour configurer les types de fichiers bloqués, utilisez le paramètre FileTypes.

La syntaxe valide pour ce paramètre est la suivante Type:AddressFormat:

Type : type d’adresse de messagerie valide tel que décrit dans la section « Types d’adresses » de Email stratégies d’adresses dans Exchange Server. Par exemple, SMTP pour l’adresse de messagerie principale, et smtp pour les adresses proxy.
AddressFormat : pour les adresses e-mail SMTP, un domaine ou un sous-domaine configuré en tant que domaine accepté (faisant autorité ou relais interne), ainsi que des variables valides et des caractères de texte ASCII, comme décrit dans la section « Formats d’adresse » de la rubrique Email stratégies d’adresse dans Exchange Server. Par exemple : alias@contoso.com nécessite la valeur %m@contoso.com, et firstname.lastname@contoso.com exige la valeur %g.%s@contoso.com.

Ce paramètre nécessite au moins un modèle avec la valeur Type SMTP (pour définir l’adresse e-mail SMTP principale). Ensuite, si vous n’incluez pas de préfixe de type pour un modèle, la valeur smtp (une adresse proxy SMTP) est supposée.

Vous pouvez spécifier plusieurs modèles d’adresses e-mail séparées par des virgules : "SMTP:PrimarySMTPEmailAddress","[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN".

Vous ne pouvez pas utiliser ce paramètre avec le paramètre EnabledPrimarySMTPAddressTemplate.

Dans Exchange Online PowerShell, vous ne pouvez pas utiliser de variables dans le modèle d’adresse e-mail.

Propriétés du paramètre

Type:	ProxyAddressTemplateCollection
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

AllTemplatesWithCustomFilter

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

AllTemplatesForUnifiedGroupRecipientsFilter

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-EnabledPrimarySMTPAddressTemplate

Le paramètre EnabledPrimarySMTPAddressTemplate spécifie la règle de la stratégie d’adresse e-mail utilisée pour générer les adresses e-mail SMTP principales des destinataires. Vous pouvez utiliser ce paramètre au lieu de EnabledEmailAddressTemplates si la stratégie applique uniquement l’adresse e-mail principale et aucune adresse proxy supplémentaire.

La syntaxe valide pour ce paramètre est un domaine ou un sous-domaine configuré en tant que domaine accepté faisant autorité, ainsi que des variables valides et des caractères de texte ASCII comme décrit dans la section « Format d’adresse » de Email stratégies d’adresse dans Exchange Server. Par exemple : alias@contoso.com nécessite la valeur %m@contoso.com, et firstname.lastname@contoso.com exige la valeur %g.%s@contoso.com.

Vous ne pouvez pas utiliser ce paramètre avec le paramètre EnabledEmailAddressTemplates.

Dans Exchange Online PowerShell, vous ne pouvez pas utiliser de variables dans le modèle d’adresse e-mail.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithCustomFilter

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateForUnifiedGroupRecipientsFilter

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-IncludedRecipients

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre IncludedRecipients spécifie un filtre prédéfini basé sur le type de destinataire. Les valeurs valides sont les suivantes :

AllRecipients : cette valeur ne peut être utilisée que seule.
Utilisateurs de boîte aux lettres
MailContacts
Groupes de messagerie
MailUsers
MailUsers

Vous pouvez spécifier plusieurs valeurs séparées par des virgules. Lorsque vous utilisez plusieurs valeurs, l’opérateur booléen OU est appliqué.

Vous devez utiliser ce paramètre lorsque vous utilisez des paramètres conditionnels dans le cadre d’un filtre prédéfini. Vous ne pouvez pas utiliser ce paramètre en combinaison avec le paramètre RecipientFilter (qui est utilisé pour créer des filtres OPATH personnalisés).

Propriétés du paramètre

Type:	WellKnownRecipientType
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithPrecannedFilter

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithPrecannedFilter

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-IncludeUnifiedGroupRecipients

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le commutateur IncludeUnifiedGroupRecipients spécifie que la stratégie d’adresse e-mail s’applique uniquement aux Groupes Microsoft 365. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Dans Exchange Online PowerShell, vous devez toujours utiliser ce commutateur, car les stratégies d’adresse e-mail dans Exchange Online s’appliquent uniquement aux groupes Microsoft 365.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesForUnifiedGroupRecipientsFilter

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateForUnifiedGroupRecipientsFilter

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ManagedByFilter

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre ManagedByFilter spécifie les stratégies d’adresses e-mail à appliquer aux groupes Microsoft 365 en fonction des propriétés des utilisateurs qui créent les groupes Microsoft 365.

Ce paramètre est un filtre OPATH basé sur la valeur de toute propriété de destinataire disponible (par exemple, "Department -eq 'Sales'"). Vous pouvez utiliser n’importe quel opérateur Windows PowerShell disponible, et les caractères génériques et les correspondances partielles sont pris en charge. Les critères de recherche utilisent la syntaxe "Property -ComparisonOperator 'Value'".

Encadrez l’ensemble du filtre OPATH entre guillemets doubles " « . Si le filtre contient des valeurs système (par exemple, $true, $falseou $null), utilisez plutôt des guillemets simples ' '. Bien que ce paramètre soit une chaîne (pas un bloc système), vous pouvez également utiliser des accolades { }, mais uniquement si le filtre ne contient pas de variables.
La propriété est une propriété filtrable. Pour connaître les propriétés des destinataires filtrables, voir Propriétés filtrables pour le paramètre RecipientFilter.
ComparisonOperator est un opérateur de comparaison OPATH (par exemple -eq , pour les égaux et -like pour les chaînes). Pour plus d'informations sur les opérateurs de comparaison, reportez-vous à la rubrique about_Comparison_Operators.
La valeur est la valeur de la propriété à rechercher. Placer les valeurs de texte et les variables entre guillemets simples ('Value' ou '$Variable'). Si une valeur de variable contient des guillemets simples, vous devez identifier les guillemets simples (échappement) pour développer correctement la variable. Par exemple, au lieu de '$User', utilisez '$($User -Replace "'","''")'. Ne placez pas d’entiers ou de valeurs système entre guillemets (par exemple, utilisez 500, $true, $falseou $null à la place).
Le premier caractère ne peut pas être un caractère générique. Par exemple, 'Sales*' est autorisé, mais '*Sales' n’est pas autorisé.

Pour plus d’informations, voir Choisir le domaine à utiliser lors de la création de groupes Microsoft 365.

Pour plus d’informations sur les filtres OPATH dans Exchange, consultez Informations supplémentaires sur la syntaxe OPATH.

Vous pouvez uniquement utiliser ce paramètre dans Exchange Online PowerShell avec le commutateur IncludeUnifiedGroupRecipients.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesForUnifiedGroupRecipientsFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateForUnifiedGroupRecipientsFilter

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Name

Le paramètre Name spécifie le nom unique de la stratégie d’adresse de messagerie. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	1
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Priority

Le paramètre Priority spécifie l’ordre dans lequel les stratégies d’adresse e-mail sont évaluées. Par défaut, chaque fois que vous ajoutez une nouvelle stratégie d’adresse e-mail, la stratégie se voit attribuer une priorité de N+1, où N est le nombre de stratégies d’adresse e-mail que vous avez créées.

Le paramètre Priority spécifie l’ordre dans lequel les stratégies d’adresse de messagerie sont évaluées. Par défaut, chaque fois que vous ajoutez une nouvelle stratégie d’adresse de messagerie, la stratégie obtient une priorité de N+1 ; où N correspond au nombre de stratégies d’adresse de messagerie que vous avez créées.

Remarque : la stratégie de première adresse e-mail qui identifie un destinataire configure les adresses e-mail de ce dernier. Toutes les autres stratégies sont ignorées, même si la première stratégie est annulée et ne peut pas configurer les adresses de messagerie du destinataire.

Propriétés du paramètre

Type:	EmailAddressPolicyPriority
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-RecipientContainer

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre RecipientContainer spécifie un filtre basé sur l’emplacement du destinataire dans Active Directory. L’entrée valide pour ce paramètre est une unité d’organisation (UO) ou un domaine retourné par l’applet de commande Get-OrganizationalUnit. Vous pouvez utiliser n’importe quelle valeur qui identifie de façon unique l’unité d’organisation ou le domaine. Par exemple :

Nom
Nom
Nom unique
GUID

GUID

Propriétés du paramètre

Type:	OrganizationalUnitIdParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-RecipientFilter

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre RecipientFilter spécifie un filtre OPATH personnalisé basé sur la valeur de toute propriété de destinataire disponible. Vous pouvez utiliser n’importe quel opérateur Windows PowerShell disponible, et les caractères génériques et les correspondances partielles sont pris en charge. Les critères de recherche utilisent la syntaxe "Property -ComparisonOperator 'Value'".

Encadrez l’ensemble du filtre OPATH entre guillemets doubles " « . Si le filtre contient des valeurs système (par exemple, $true, $falseou $null), utilisez plutôt des guillemets simples ' '. Bien que ce paramètre soit une chaîne (pas un bloc système), vous pouvez également utiliser des accolades { }, mais uniquement si le filtre ne contient pas de variables.
La propriété est une propriété filtrable. Pour connaître les propriétés filtrables, voir Propriétés filtrables pour le paramètre RecipientFilter.
ComparisonOperator est un opérateur de comparaison OPATH (par exemple -eq , pour les égaux et -like pour les chaînes). Pour plus d'informations sur les opérateurs de comparaison, reportez-vous à la rubrique about_Comparison_Operators.
La valeur est la valeur de la propriété sur laquelle filtrer. Placer les valeurs de texte et les variables entre guillemets simples ('Value' ou '$Variable'). Si une valeur de variable contient des guillemets simples, vous devez identifier les guillemets simples (échappement) pour développer correctement la variable. Par exemple, au lieu de '$User', utilisez '$($User -Replace "'","''")'. Ne placez pas d’entiers ou de valeurs système entre guillemets (par exemple, utilisez 500, $true, $falseou $null à la place).
Dans les environnements cloud, vous ne pouvez pas utiliser un caractère générique comme premier caractère. Par exemple, 'Sales*' est autorisé, mais '*Sales' n’est pas autorisé.
Dans Exchange local, les caractères génériques ne sont valides qu’en tant que premier ou dernier caractère. Par exemple, 'Sales*' ou '*Sales' sont autorisés, mais 'Sa*les' ne l’est pas.

Pour plus d’informations sur les filtres OPATH dans Exchange, consultez Informations supplémentaires sur la syntaxe OPATH.

Vous ne pouvez pas utiliser ce paramètre en combinaison avec le paramètre IncludedRecipients ou des paramètres conditionnels (qui sont utilisés pour créer des filtres prédéfinis).

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

AllTemplatesWithCustomFilter

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

SMTPTemplateWithCustomFilter

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-WhatIf

Le commutateur WhatIf affiche ce que la commande fait sans apporter de modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

Commentaires

Cette page a-t-elle été utile ?