New-DynamicDistributionGroup
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-DynamicDistributionGroup permet de créer des groupes de distribution dynamiques. Un groupe de distribution dynamique interroge des objets à extension messagerie et crée l’appartenance au groupe sur la base des résultats. L’appartenance au groupe est recalculée chaque fois qu’un message électronique est envoyé au groupe.
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-DynamicDistributionGroup
[-Name] <String>
-IncludedRecipients <WellKnownRecipientType>
[-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>]
[-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]
[-DirectMembershipOnly <Boolean>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-PrimarySmtpAddress <SmtpAddress>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-SendModerationNotifications <TransportModerationNotificationFlags>]
[-WhatIf]
[<CommonParameters>]
New-DynamicDistributionGroup
[-Name] <String>
-RecipientFilter <String>
[-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>]
[-Confirm]
[-DirectMembershipOnly <Boolean>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-PrimarySmtpAddress <SmtpAddress>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-SendModerationNotifications <TransportModerationNotificationFlags>]
[-WhatIf]
[<CommonParameters>]
Description
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 personnalisé.
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-DynamicDistributionGroup -Name "Marketing Group" -IncludedRecipients "MailboxUsers,MailContacts" -ConditionalDepartment "Marketing","Sales"
L’exemple suivant crée un groupe de distribution dynamique nommé Marketing Group qui contient l’ensemble des destinataires ayant un champ Department équivalant aux chaînes « Marketing » ou « Sales ». Étant donné que nous n’utilisons pas les paramètres OrganizationalUnit ou RecipientContainer, le groupe recherche les destinataires à l’emplacement par défaut (en général, le conteneur Utilisateurs).
Exemple 2
New-DynamicDistributionGroup -Name "Washington Management Team" -RecipientFilter "(RecipientType -eq 'UserMailbox') -and (Title -like 'Director*' -or Title -like 'Manager*') -and (StateOrProvince -eq 'WA')" -RecipientContainer "North America"
Cet exemple crée un groupe de distribution dynamique nommé Washington Management Team qui contient tous les utilisateurs de l’unité d’organisation nommée Amérique du Nord de l’État de Washington dont les titres commencent par « Directeur » ou « Manager ».
Paramètres
-Alias
Le paramètre Alias spécifie l’alias Exchange (également appelé surnom de messagerie) pour le destinataire. Cette valeur identifie le destinataire en tant qu’objet à extension messagerie et ne doit pas être confondue avec plusieurs adresses e-mail pour le même destinataire (également appelées adresses proxy). Un destinataire ne peut avoir qu’une seule valeur Alias. La longueur maximale est de 64 caractères.
La valeur Alias peut contenir des lettres, des chiffres et les caractères suivants :
- !, #, %, *, +, -, /, =, ?, ^, _, et ~.
- $, &, ', ', {, }et | doivent être placés dans une séquence d’échappement (par exemple
-Alias what`'snew
) ou la valeur entière placée entre guillemets simples (par exemple,-Alias 'what'snew'
). Le & caractère n’est pas pris en charge dans la valeur Alias pour la synchronisation Azure AD Connect. - Les points (.) doivent être entourés d’autres caractères valides (par exemple,
help.desk
). - Caractères Unicode U+00A1 à U+00FF.
Lorsque vous créez un destinataire sans spécifier d’adresse e-mail, la valeur Alias que vous spécifiez est utilisée pour générer l’adresse e-mail principale (alias@domain
). Les caractères Unicode pris en charge sont mappés avec les caractères de texte US-ASCII les plus adaptés. Par exemple, U+00F6 (ö) est remplacé par oe
dans l’adresse e-mail principale.
Si vous n’utilisez pas le paramètre Alias lorsque vous créez un destinataire, la valeur d’un autre paramètre requis est utilisée pour la valeur de la propriété Alias :
- Destinataires avec des comptes d’utilisateur (par exemple, des boîtes aux lettres utilisateur et des utilisateurs de messagerie) : le côté gauche du paramètre MicrosoftOnlineServicesID ou UserPrincipalName est utilisé. Par exemple, helpdesk@contoso.onmicrosoft.com génère la valeur
helpdesk
de la propriété Alias . - Destinataires sans compte d’utilisateur (par exemple, boîtes aux lettres de salle, contacts de messagerie et groupes de distribution) : la valeur du paramètre Name est utilisée. Les espaces sont supprimés et les caractères non pris en charge sont convertis en points d’interrogation (?).
Si vous modifiez la valeur Alias d’un destinataire existant, l’adresse e-mail principale est automatiquement mise à jour uniquement dans les environnements où le destinataire est soumis à des stratégies d’adresse de messagerie (la propriété EmailAddressPolicyEnabled a la valeur True pour le destinataire).
Le paramètre Alias ne génère ni ne met à jour l’adresse e-mail principale d’un contact de messagerie ou d’un utilisateur de messagerie.
Type: | String |
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, Exchange Online Protection |
-ArbitrationMailbox
Ce paramètre est disponible uniquement dans Exchange sur site.
Le paramètre ArbitrationMailbox spécifie la boîte aux lettres d’arbitrage utilisée pour gérer le processus de modération pour ce destinataire. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la boîte aux lettres d’arbitrage. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Domaine\Nom d’utilisateur
- Adresse e-mail
- GUID
- LegacyExchangeDN
- SamAccountName
- Identifiant utilisateur ou nom d’utilisateur principal (UPN)
Type: | MailboxIdParameter |
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 |
-ConditionalCompany
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute1
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute10
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute11
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute12
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute13
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute14
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute15
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute2
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute3
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute4
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute5
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute6
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute7
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute8
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, Exchange Online, Exchange Online Protection |
-ConditionalCustomAttribute9
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, Exchange Online, Exchange Online Protection |
-ConditionalDepartment
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, Exchange Online, Exchange Online Protection |
-ConditionalStateOrProvince
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, Exchange Online, Exchange Online Protection |
-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, Exchange Online Protection |
-DirectMembershipOnly
Ce paramètre est disponible uniquement dans le service basé sur le cloud.
Ce paramètre est réservé à l’usage interne chez Microsoft.
Type: | Boolean |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-DisplayName
Le paramètre DisplayName spécifie le nom complet du groupe de distribution dynamique. Le nom complet est visible dans le Centre d’administration Exchange et dans les listes d’adresses. La longueur maximale est de 256 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Si vous n’utilisez pas le paramètre DisplayName, la valeur du paramètre Name est utilisée pour le nom complet.
Type: | String |
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, Exchange Online Protection |
-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 |
-IncludedRecipients
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, Exchange Online, Exchange Online Protection |
-ModeratedBy
Le paramètre ModeratedBy spécifie un ou plusieurs modérateurs pour ce destinataire. Un modérateur approuve les messages envoyés au destinataire avant qu’ils ne soient remis. Un modérateur doit être une boîte aux lettres, un utilisateur de messagerie ou un contact de messagerie de votre organisation. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique le modérateur. Par exemple :
- Nom
- Alias
- Nom unique
- Nom unique
- Nom unique canonique
- GUID
Vous pouvez entrer plusieurs valeurs séparées par des virgules. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN"
.
Vous utilisez ce paramètre pour spécifier au moins un modérateur lorsque vous définissez le paramètre ModerationEnabled sur la valeur $true.
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, Exchange Online, Exchange Online Protection |
-ModerationEnabled
Le paramètre ModerationEnabled spécifie si la modération est activée pour ce destinataire. Les valeurs valides sont les suivantes :
- $true : la modération est activée pour ce destinataire. Les messages envoyés à ce destinataire doivent être approuvés par un modérateur avant la remise des messages.
- $false : la modération est désactivée pour ce destinataire. Les messages envoyés à ce destinataire sont remis sans l’approbation d’un modérateur. Il s’agit de la valeur par défaut.
Vous utilisez le paramètre ModeratedBy pour spécifier les modérateurs.
Type: | Boolean |
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, Exchange Online Protection |
-Name
Le paramètre Name spécifie le nom unique du groupe de distribution dynamique. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Cette valeur est également utilisée pour la propriété DisplayName si vous n’utilisez pas le paramètre DisplayName.
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, Exchange Online Protection |
-OrganizationalUnit
Le paramètre OrganizationalUnit spécifie l’unité d’organisation où le groupe de distribution dynamique est créé.
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
Si vous n’utilisez pas ce paramètre, la valeur par défaut est généralement le conteneur Users dans le domaine du serveur Exchange auquel vous êtes connecté (également appelé étendue du destinataire). Dans Exchange local, vous pouvez modifier l’étendue du destinataire de la session PowerShell actuelle à l’aide de l’applet de commande Set-AdServerSettings.
Si vous n’utilisez pas le paramètre RecipientContainer, l’emplacement du groupe de distribution dynamique est utilisé pour la propriété RecipientContainer (emplacement par défaut ou valeur que vous spécifiez pour le paramètre OrganizationalUnit).
Remarque : Bien que ce paramètre soit disponible dans Exchange Online, il n’y a qu’une seule unité d’organisation utilisable dans une organisation Exchange Online. L’utilisation de ce paramètre n’a donc aucun effet.
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, Exchange Online, Exchange Online Protection |
-PrimarySmtpAddress
Le paramètre PrimarySmtpAddress spécifie l’adresse de messagerie de retour principale qui est utilisée pour le destinataire.
Type: | SmtpAddress |
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, Exchange Online Protection |
-RecipientContainer
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
La propriété RecipientContainer ne peut pas être vide. Le groupe est toujours limité à la recherche de destinataires dans un emplacement spécifique (la valeur que vous spécifiez pour ce paramètre ou l’emplacement où le groupe a été créé).
Remarque : Bien que ce paramètre soit disponible dans Exchange Online, il n’y a qu’une seule unité d’organisation utilisable dans une organisation Exchange Online. L’utilisation de ce paramètre n’a donc aucun effet.
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, Exchange Online, Exchange Online Protection |
-RecipientFilter
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
,$false
ou$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
-eq
pour des valeurs égales et-like
pour 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
,$false
ou$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).
La longueur maximale de la propriété RecipientFilter est de 2 048 caractères, y compris la syntaxe interne.
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, Exchange Online Protection |
-SendModerationNotifications
Les connexions client sont transmises par proxy des services d’accès au client vers les services principaux sur des serveurs de boîtes aux lettres locaux ou distants. Les valeurs valides sont les suivantes :
- Toujours : informez tous les expéditeurs lorsque leurs messages ne sont pas approuvés. Il s’agit de la valeur par défaut.
- Always : avertir tous les expéditeurs lorsque leurs messages ne sont pas approuvés. Il s’agit de la valeur par défaut.
- Internal : avertir les expéditeurs de l’organisation lorsque leurs messages ne sont pas approuvés.
Ce paramètre est significatif uniquement lorsque la modération est activée (le paramètre ModerationEnabled a la valeur $true).
Type: | TransportModerationNotificationFlags |
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, Exchange Online Protection |
-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, Exchange Online Protection |
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.