New-AddressList

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-AddressList permet de créer des listes d’adresses et de les appliquer à des destinataires.

Dans Exchange Online, cette applet de commande est disponible uniquement dans le rôle Listes d’adresses et, par défaut, le rôle n’est attribué à aucun groupe de rôles. Pour utiliser cette applet de commande, vous devez ajouter le rôle Listes d’adresses à un groupe de rôles (par exemple, au groupe de rôles Gestion de l’organisation). Pour plus d'informations, consultez la section relative à l'Ajouter un rôle à un groupe de rôles.

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-AddressList
   [-Name] <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]
   [-Container <AddressListIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-WhatIf]
   [<CommonParameters>]
New-AddressList
   [-Name] <String>
   -RecipientFilter <String>
   [-Confirm]
   [-Container <AddressListIdParameter>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-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.

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-AddressList -Name MyAddressList -RecipientFilter "((RecipientTypeDetails -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))"

Cet exemple crée la liste d'adresses MyAddressList. La liste d'adresses inclut les destinataires qui sont des utilisateurs de boîte aux lettres et pour lesquels la propriété StateOrProvince est définie sur Washington ou Oregon.

Exemple 2

New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers

Cet exemple crée la liste d'adresses MyAddressList2 qui inclut des boîtes aux lettres dont le paramètre ConditionalStateOrProvince est défini sur Washington.

Exemple 3

New-AddressList -Name "AL_AgencyB" -RecipientFilter "((RecipientTypeDetails -eq 'UserMailbox') -and (CustomAttribute15 -like 'AgencyB*'))"

Cet exemple crée la liste d'adresses AL_AgencyB qui inclut des boîtes aux lettres qui disposent de la valeur du paramètre CustomAttribute15 contenant AgencyB.

Paramètres

-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

-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

-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

-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

-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

-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

-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

-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

-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

-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

-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

-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

-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

-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

-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

-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

-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

-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

-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

-Container

Le paramètre Container spécifie où créer la liste d’adresses. Une entrée valide pour ce paramètre est un emplacement situé sous la racine « \ » (également appelée Toutes les listes d’adresses) ou sous une liste d’adresses existante. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique la liste d’adresses. Par exemple :

  • Nom
  • Nom unique (DN)
  • GUID
  • Chemin d’accès : "\AddressListName" ou "\ContainerName\AddressListName" (par exemple, "\All Users" ou "\All Contacts\Marketing")

Si vous n’utilisez pas ce paramètre, la liste d’adresses est créée sous la racine (\).

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

-DisplayName

Le paramètre DisplayName spécifie le nom complet de la liste d'adresses. Le nom d’affichage est visible dans le Centre d’administration Exchange et Outlook. 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

-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

-Name

Le paramètre Name spécifie le nom unique de la nouvelle liste d’adresses. La longueur maximale est de 64 caractères et le caractère de retour chariot et la barre oblique inverse (\) sont interdits. 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

-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

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 -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, utilisez 500, $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, Exchange Online

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