New-DynamicDistributionGroup

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

Syntaxe

PrecannedFilter

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>]
    [-ManagedBy <GeneralRecipientIdParameter>]
    [-DomainController <Fqdn>]
    [-ModeratedBy <MultiValuedProperty>]
    [-ModerationEnabled <Boolean>]
    [-Notes <String>]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-PrimarySmtpAddress <SmtpAddress>]
    [-RecipientContainer <OrganizationalUnitIdParameter>]
    [-SendModerationNotifications <TransportModerationNotificationFlags>]
    [-WhatIf]
    [<CommonParameters>]

CustomFilter

New-DynamicDistributionGroup
    [-Name] <String>
    -RecipientFilter <String>
    [-Alias <String>]
    [-ArbitrationMailbox <MailboxIdParameter>]
    [-Confirm]
    [-DirectMembershipOnly <Boolean>]
    [-DisplayName <String>]
    [-ManagedBy <GeneralRecipientIdParameter>]
    [-DomainController <Fqdn>]
    [-ModeratedBy <MultiValuedProperty>]
    [-ModerationEnabled <Boolean>]
    [-Notes <String>]
    [-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 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 personnalisé.

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-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 "(RecipientTypeDetails -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 « Responsable ».

Paramètres

-Alias

Le paramètre Alias spécifie l’alias Exchange (également connu sous le nom de surnom de courrier) 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 ~.
$, &, ', ', ', {, }, and | doivent être placées dans une séquence d’échappement (par exemple -Alias what`'snew, ) ou la valeur entière doit être placée entre guillemets simples (par exemple, -Alias 'what'snew'). Le caractère & n’est pas pris en charge dans la valeur Alias pour Microsoft Entra Connect synchronisation.
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 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 obligatoire est utilisée pour la valeur de la propriété Alias :

Destinataires avec des comptes d’utilisateur (par exemple, boîtes aux lettres utilisateur et utilisateurs de courrier) : le côté gauche du paramètre MicrosoftOnlineServicesID ou UserPrincipalName est utilisé. Par exemple, helpdesk@contoso.onmicrosoft.com le résultat de la valeur helpdeskde 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 Nom 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 e-mail (la propriété EmailAddressPolicyEnabled est True pour le destinataire).

Le paramètre Alias ne génère ni ne met jamais à jour l’adresse e-mail principale d’un contact de messagerie ou d’un utilisateur de messagerie.

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:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

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

Propriétés du paramètre

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

-ConditionalCompany

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

PrecannedFilter

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

-ConditionalCustomAttribute1

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

PrecannedFilter

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

-ConditionalCustomAttribute10

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

PrecannedFilter

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

-ConditionalCustomAttribute11

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

PrecannedFilter

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

-ConditionalCustomAttribute12

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

PrecannedFilter

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

-ConditionalCustomAttribute13

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

PrecannedFilter

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

-ConditionalCustomAttribute14

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

PrecannedFilter

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

-ConditionalCustomAttribute15

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

PrecannedFilter

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

-ConditionalCustomAttribute2

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

PrecannedFilter

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

-ConditionalCustomAttribute3

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

PrecannedFilter

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

-ConditionalCustomAttribute4

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

PrecannedFilter

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

-ConditionalCustomAttribute5

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

PrecannedFilter

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

-ConditionalCustomAttribute6

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

PrecannedFilter

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

-ConditionalCustomAttribute7

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

PrecannedFilter

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

-ConditionalCustomAttribute8

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

PrecannedFilter

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

-ConditionalCustomAttribute9

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

PrecannedFilter

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

-ConditionalDepartment

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

PrecannedFilter

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

-ConditionalStateOrProvince

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

PrecannedFilter

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

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

Propriétés du paramètre

Type:	Boolean
Valeur par défaut:	False
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

-DisplayName

Le paramètre DisplayName spécifie le nom complet du groupe de distribution dynamique. Le nom d’affichage 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.

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

-IncludedRecipients

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

PrecannedFilter

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

-ManagedBy

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

Propriétés du paramètre

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

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

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

(All)

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

-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 d’être remis.
$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. Cette valeur est la valeur par défaut.

Vous utilisez le paramètre ModeratedBy pour spécifier les modérateurs.

Propriétés du paramètre

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

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

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

-Notes

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

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:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-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 des utilisateurs dans le domaine du serveur Exchange auquel vous êtes connecté (également appelé étendue de destinataire). Dans Exchange local, vous pouvez modifier l’étendue de destinataire de la session PowerShell active à 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 un Exchange Online organization, donc l’utilisation de ce paramètre n’a aucun effet.

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

-PrimarySmtpAddress

Le paramètre PrimarySmtpAddress spécifie l’adresse de messagerie de retour principale qui est utilisée pour le destinataire.

Propriétés du paramètre

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

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éé).

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

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).

La longueur maximale de la propriété RecipientFilter est de 2 048 caractères, y compris la syntaxe interne.

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

CustomFilter

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

-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 : Avertir tous les expéditeurs lorsque leurs messages ne sont pas approuvés. Cette valeur est 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 n’a de sens que lorsque la modération est activée (le paramètre ModerationEnabled a la valeur $true).

Propriétés du paramètre

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

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