Modification de propriétés à valeurs multiples

S’applique à : Exchange Server 2013

Une propriété à valeurs multiples est une propriété qui peut contenir plusieurs valeurs. Par exemple, la propriété BlockedRecipients sur l'objet RecipientFilterConfig peut accepter plusieurs adresses de destinataire, par exemple :

  • john@contoso.com
  • kim@northwindtraders.com
  • david@adatum.com

Étant donné que la propriété BlockedRecipients peut accepter plusieurs valeurs, elle est appelée propriété à valeurs multiples. Cette rubrique explique comment utiliser l'environnement de ligne de commande Exchange Management Shell pour ajouter et supprimer des valeurs d'une propriété à valeurs multiples sur un objet.

Pour plus d’informations sur les objets, consultez Données structurées. Pour plus d’informations sur l’interpréteur de commandes, consultez Utilisation de PowerShell avec Exchange 2013 (Exchange Management Shell).

Modification d’une propriété à valeurs multiples et d’une propriété n’acceptant qu’une seule valeur

La procédure de modification d’une propriété à valeurs multiples diffère légèrement de la procédure de modification d’une propriété n’acceptant qu’une valeur. Lorsque vous modifiez une propriété qui n'accepte qu'une valeur, vous pouvez lui affecter directement une valeur, comme dans la commande suivante.

Set-TransportConfig -MaxSendSize 12MB

Lorsque vous utilisez cette commande pour fournir une nouvelle valeur à la propriété MaxSendSize , la valeur stockée est remplacée. Ce n’est pas un problème avec les propriétés qui n’acceptent qu’une seule valeur. Toutefois, cela devient un problème avec les propriétés à plusieurs valeurs. Par exemple, supposons que la propriété BlockedRecipients sur l’objet RecipientFilterConfig soit configurée pour avoir les trois valeurs répertoriées dans la section précédente. Lorsque vous exécutez la commande Get-RecipientFilterConfig | Format-List BlockedRecipients, les éléments suivants s’affichent.

BlockedRecipients : {david@adatum.com, kim@northwindtraders.com, john@contoso.com}

Supposons maintenant que vous avez reçu une demande pour ajouter une nouvelle adresse SMTP à la liste des destinataires bloqués. Vous devez exécuter la commande suivante pour ajouter la nouvelle adresse SMTP.

Set-RecipientFilterConfig -BlockedRecipients chris@contoso.com

Lorsque vous réexécutez la Get-RecipientFilterConfig | Format-List BlockedRecipients commande, vous verrez ce qui suit.

BlockedRecipients : {chris@contoso.com}

Ce n'est pas ce que vous attendiez. Vous souhaitiez ajouter la nouvelle adresse SMTP à la liste existante de destinataires bloqués, mais celle-ci a été remplacée par la nouvelle adresse SMTP. Ce résultat inattendu montre à titre d'exemple comment la modification de propriétés à valeurs multiples diffère de celle des propriétés qui n'acceptent qu'une seule valeur. Lorsque vous modifiez une propriété à valeurs multiples, vous devez veiller à ajouter ou supprimer les valeurs et non pas remplacer l'ensemble de la liste de valeurs. Les sections suivantes vous indiquent comment procéder.

Comment modifier les propriétés à valeurs multiples

La modification des propriétés à valeurs multiples suit le même processus que si vous modifiiez des propriétés à valeur unique. Il vous suffit d'ajouter une syntaxe supplémentaire pour indiquer à l'environnement de ligne de commande Exchange Management Shell que vous souhaitez ajouter ou supprimer des valeurs vers ou à partir de la propriété à valeurs multiples plutôt que de remplacer tout le contenu stocké dans la propriété. Tout comme la ou les valeurs à ajouter dans la propriété ou à supprimer de celle-ci, la syntaxe est incluse et apparaît sous la forme d'une valeur dans un paramètre lorsque vous exécutez une cmdlet. Le tableau qui suit présente la syntaxe que vous devez ajouter à un paramètre dans une cmdlet pour modifier les propriétés à valeurs multiples.

Syntaxe de propriété à valeurs multiples

Action Syntaxe
Ajouter une ou plusieurs valeurs à une propriété à valeurs multiples @{Add="<value1>", "<value2>", "<value3>"}
Supprimer une ou plusieurs valeurs d’une propriété à valeurs multiples @{Remove="<value1>", "<value2>", "<value3>"}

La syntaxe que vous choisissez dans la table de syntaxe de propriétés à valeurs multiples est spécifiée en tant que valeur de paramètre sur une applet de commande. Par exemple, la commande suivante ajoute plusieurs valeurs à une propriété à valeurs multiples :

Set-ExampleCmdlet -Parameter @{Add="Red", "Blue", "Green"}

Lorsque vous utilisez cette syntaxe, les valeurs que vous spécifiez sont ajoutées ou supprimées de la liste des valeurs déjà présentes dans la propriété. Pour prendre l’exemple BlockedRecipients plus haut dans cette rubrique, nous pouvons maintenant ajouter chris@contoso.com sans remplacer le reste des valeurs de cette propriété à l’aide de la commande suivante :

Set-RecipientFilterConfig -BlockedRecipients @{Add="chris@contoso.com"}

Si vous souhaitez supprimer david@adatum.com de la liste des valeurs, vous devez utiliser cette commande :

Set-RecipientFilterConfig -BlockedRecipients @{Remove="david@adatum.com"}

Des combinaisons plus complexes peuvent être utilisées, notamment en ajoutant ou en supprimant simultanément des éléments dans une propriété. Pour ce faire, insérez un point-virgule (; ) entre Add les actions et Remove . Par exemple :

Set-RecipientFilterConfig -BlockedRecipients @{Add="carter@contoso.com", "sam@northwindtraders.com", "brian@adatum.com"; Remove="john@contoso.com"}

Si nous utilisons à nouveau la Get-RecipientFilterConfig | Format-List BlockedRecipients commande, nous pouvons voir que les adresses e-mail de Carter, Sam et Brian ont été ajoutées tandis que l’adresse de John a été supprimée.

BlockedRecipients : {brian@adatum.com, sam@northwindtraders.com, carter@contoso.com, chris@contoso.com, kim@northwindtraders.com}