New-EmailAddressPolicy
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.
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 ne sont disponibles que 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.
Syntax
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>] New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
-RecipientFilter <String>
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] 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>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
-RecipientFilter <String>
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
[-IncludeUnifiedGroupRecipients]
[-ManagedByFilter <String>]
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] 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 une organisation Exchange locale, 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 une 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 cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été 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écannisé :
- Nom : Bureaux Sud-Est
- Filtre de destinataire précanné : tous les utilisateurs avec des boîtes aux lettres dont la valeur d’état ou de 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 - Priority:N+1, où N est le nombre de stratégies d’adresse e-mail créées manuellement qui existent déjà (nous n’avons pas utilisé le paramètre Priority et la valeur par défaut est N+1).
Exemple 2
New-EmailAddressPolicy -Name "Northwest Executives" -RecipientFilter "(RecipientType -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 2Cet 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 avec des boîtes aux lettres où la valeur Title contient Director ou Manager, et où la valeur d’état ou de 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écanné 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute1
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute1 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute1 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute10
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute10 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute10 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute11
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute11 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute11 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute12
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute12 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute12 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute13
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute13 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute13 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute14
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute14 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute14 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute15
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute15 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute15 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute2
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute2 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute2 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute3
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute3 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute3 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute4
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute4 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute4 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute5
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute5 spécifie un filtre précanné basé sur la valeur de la propriété CustomAttribute5 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute6
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute6 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute6 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute7
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute7 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute7 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute8
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute8 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute8 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalCustomAttribute9
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalCustomAttribute9 spécifie un filtre précannisé basé sur la valeur de la propriété CustomAttribute9 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalDepartment
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalDepartment spécifie un filtre précannisé basé sur la valeur de la propriété Department 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ConditionalStateOrProvince
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ConditionalStateOrProvince spécifie un filtre précanné basé sur la valeur de la propriété StateOrProvince 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 OR est appliqué. Pour plus d’informations sur le fonctionnement des paramètres conditionnels, consultez la section Description détaillée de cette rubrique.
Vous utilisez ce paramètre en combinaison avec le paramètre IncludedRecipients dans le cadre d’un filtre précannisé. 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).
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont 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 cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DisabledEmailAddressTemplates
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre DisabledEmailAddressTemplates spécifie les modèles d’adresses de messagerie 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 Type:AddressFormat:
- Type : type d’adresse e-mail valide, comme décrit dans la section « Types d’adresses » dans Email stratégies d’adresse dans Exchange Server. Par exemple, smtp ou X400. Notez que 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é comme domaine accepté (relais faisant autorité ou interne), ainsi que des variables valides et des caractères de texte ASCII comme décrit dans la section « Formats d’adresse » dans Email stratégies d’adresse dans Exchange Server. Par exemple : alias@contoso.com nécessite la valeur
%m@contoso.comet firstname.lastname@contoso.com la valeur%g.%s@contoso.com.
Vous pouvez spécifier plusieurs modèles d’adresses e-mail désactivés séparés par des virgules : "[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN".
| Type: | ProxyAddressTemplateCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 ».
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EnabledEmailAddressTemplates
Pour configurer les types de fichiers bloqués, utilisez le paramètre FileTypes.
La syntaxe valide pour ce paramètre est Type:AddressFormat:
- Type : type d’adresse e-mail valide, comme décrit dans la section « Types d’adresses » dans Email stratégies d’adresse 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é comme domaine accepté (relais faisant autorité ou interne), ainsi que des variables valides et des caractères de texte ASCII comme décrit dans la section « Formats d’adresse » dans Email stratégies d’adresse dans Exchange Server. Par exemple : alias@contoso.com nécessite la valeur
%m@contoso.comet firstname.lastname@contoso.com 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). Après cela, si vous n’incluez pas de préfixe 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és 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.
| Type: | ProxyAddressTemplateCollection |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-EnabledPrimarySMTPAddressTemplate
Le paramètre EnabledPrimarySMTPAddressTemplate spécifie la règle dans la stratégie d’adresse e-mail utilisée pour générer les adresses de messagerie SMTP principales pour les destinataires. Vous pouvez utiliser ce paramètre à la place 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 » dans Email stratégies d’adresse dans Exchange Server. Par exemple : alias@contoso.com nécessite la valeur %m@contoso.comet firstname.lastname@contoso.com 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludedRecipients
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre IncludedRecipients spécifie un filtre précannisé basé sur le type de destinataire. Les valeurs valides sont les suivantes :
- AllRecipients : cette valeur ne peut être utilisée que par elle-même.
- MailboxUsers
- MailContacts
- MailGroups
- MailUsers
- MailUsers
Vous pouvez spécifier plusieurs valeurs séparées par des virgules. Lorsque vous utilisez plusieurs valeurs, l’opérateur booléen OR est appliqué.
Vous devez utiliser ce paramètre lorsque vous utilisez des paramètres conditionnels dans le cadre d’un filtre précanné. 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).
| Type: | WellKnownRecipientType |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 de messagerie dans Exchange Online sont appliquées uniquement aux groupes Microsoft 365.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ManagedByFilter
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Le paramètre ManagedByFilter spécifie les stratégies d’adresse e-mail à appliquer à Groupes Microsoft 365 en fonction des propriétés des utilisateurs qui créent le 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'".
- Placez 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 (et non un bloc système), vous pouvez également utiliser des accolades { }, mais uniquement si le filtre ne contient pas de variables. - Property est une propriété filtrable. Pour les propriétés de destinataire filtrables, consultez Propriétés filtrables pour le paramètre RecipientFilter.
- ComparisonOperator est un opérateur de comparaison OPATH (par exemple
-eqpour des valeurs égales et-likepour la comparaison de chaînes). Pour plus d'informations sur les opérateurs de comparaison, reportez-vous à la rubrique about_Comparison_Operators. - Value est la valeur de propriété à rechercher. Placez 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 (échappement) les guillemets simples pour développer la variable correctement. Par exemple, au lieu de'$User', utilisez'$($User -Replace "'","''")'. Ne placez pas entre guillemets les entiers ou les valeurs système (par exemple, utilisez500,$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, consultez Choisir le domaine à utiliser lors de la création d’Groupes Microsoft 365.
Pour plus d’informations sur les filtres OPATH dans Exchange, consultez Informations supplémentaires sur la syntaxe OPATH.
Vous pouvez utiliser ce paramètre uniquement dans Exchange Online PowerShell avec le commutateur IncludeUnifiedGroupRecipients.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 (").
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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 correspond au 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 première stratégie d’adresse e-mail qui identifie un destinataire configure les adresses e-mail du destinataire. 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.
| Type: | EmailAddressPolicyPriority |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-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
| Type: | OrganizationalUnitIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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'".
- Placez 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 (et non un bloc système), vous pouvez également utiliser des accolades { }, mais uniquement si le filtre ne contient pas de variables. - Property est une propriété filtrable. Pour les propriétés filtrables, consultez Propriétés filtrables pour le paramètre RecipientFilter.
- ComparisonOperator est un opérateur de comparaison OPATH (par exemple
-eqpour des valeurs égales et-likepour la comparaison de chaînes). Pour plus d'informations sur les opérateurs de comparaison, reportez-vous à la rubrique about_Comparison_Operators. - Value est la valeur de propriété sur laquelle filtrer. Placez 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 (échappement) les guillemets simples pour développer la variable correctement. Par exemple, au lieu de'$User', utilisez'$($User -Replace "'","''")'. Ne placez pas entre guillemets les entiers ou les valeurs système (par exemple, utilisez500,$true,$falseou$nullà la place). - Dans les environnements cloud, vous ne pouvez pas utiliser de 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 sont valides uniquement 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écanned).
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
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
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour