Modification de propriétés à valeurs multiples

S'applique à : Exchange Server 2010

Dernière rubrique modifiée : 2009-10-14

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.

Vue d'ensemble des propriétés à valeurs multiples

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 :

• jean@contoso.com
• rosalie@lescomptoirs.com
• david@adatum.com

Étant donné que la propriété BlockedRecipients peut accepter plusieurs valeurs, elle est appelée propriété à valeurs multiples.

Pour plus d'informations sur les objets, voir Données structurées.

Modification d'une propriété à valeurs multiples et d'une propriété n'acceptant qu'une 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. Cela ne pose aucun problème avec les propriétés n'acceptant qu'une valeur, ce n'est, en revanche, pas le cas avec les propriétés à valeurs multiples. Supposons par exemple que la propriété BlockedRecipients de la propriété RecipientFilterConfig est configurée pour recevoir les trois valeurs indiquées dans la section précédente. Lorsque vous exécutez la commande Get-RecipientFilterConfig | Format-List BlockedRecipients, le résultat suivant s'affiche.

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 exécutez de nouveau la commande Get-RecipientFilterConfig | Format-List BlockedRecipients, vous obtenez 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. C'est en cela que diffèrent la modification de propriétés à valeurs multiples et celle des propriétés n'acceptant 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.

Remarque :
Certaines cmdlets, telles que Set-TransportRule, ne permettent pas de modifier des propriétés sur les objets de la manière décrite dans cette rubrique. Pour plus d'informations sur l'ajout et la suppression de valeurs des propriétés à valeurs multiples de ces cmdlets, consultez les rubriques concernant ces cmdlets, comme Set-TransportRule.

Pour modifier les propriétés à valeurs multiples, vous devez maîtriser les concepts suivants :

• Variables définies par l’utilisateur
• Traitement en pipeline
• Syntaxe
• Utilisation de la sortie d’une commande

Ajouter une valeur à une propriété à valeurs multiples

Ajouter une valeur à une propriété à valeurs multiples ne présente aucune difficulté. Cela ne nécessite que quelques opérations supplémentaires. Supposons encore que la propriété BlockedRecipients contient les valeurs indiquées dans la première section de cette rubrique.

Vous devez tout d'abord extraire l'objet à modifier et l'attribuer à une variable. Par exemple, utilisez la commande suivante pour affecter l'objet RecipientFilterConfig à la variable $Example.

$Example = Get-RecipientFilterConfig

Si vous exécutez la commande $Example | Format-List BlockedRecipients, vous obtenez ce qui suit.

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

Vous devez ensuite ajouter la valeur voulue à la propriété BlockedRecipients sur l'objet stocké dans la variable $Example. Notez que cette opération ajoute uniquement la valeur à l'objet qui est stocké dans la variable. Pour ajouter chris@contoso.com à la propriété BlockedRecipients sur l'objet qui est stocké dans la variable $Example, exécutez la commande suivante.

$Example.BlockedRecipients += "chris@contoso.com"

Si vous exécutez de nouveau la commande $Example | Format-List BlockedRecipients, vous obtenez ce qui suit.

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

Comme vous pouvez le constater, l'adresse SMTP chris@contoso.com a été ajoutée à la liste des valeurs stockées dans la propriété BlockedRecipients.

Enfin, vous devez enregistrer l'objet qui est stocké dans $Example à l'aide de la commande suivante.

Set-RecipientFilterConfig -BlockedRecipients $Example.BlockedRecipients

À présent, lorsque vous exécutez la commande Get-RecipientFilterConfig | Format-List BlockedRecipients, l'adresse SMTP chris@contoso.com est bien ajoutée au serveur.

Ajout de plusieurs valeurs à une propriété à valeurs multiples

Pour ajouter simultanément un grand nombre de valeurs à une propriété à valeurs multiples, procédez comme il est indiqué ci-dessus. Séparez par des virgules les valeurs que vous souhaitez ajouter, comme dans l'exemple suivant.

$Example.BlockedRecipients += "user1@contoso.com", "user2@contoso.com", "user3@contoso.com"

Une fois que vous avez spécifié les valeurs à ajouter, enregistrez l'objet à l'aide de la cmdlet Set-RecipientFilterConfig.

Remarque :
Certaines cmdlets ne permettent pas l'ajout simultané de plusieurs valeurs.

Supprimer une valeur d'une propriété à valeurs multiples

Vous pouvez supprimer une valeur d'une propriété à valeurs multiples au lieu d'en supprimer plusieurs à la fois. La procédure de suppression d'une valeur d'une propriété à valeurs multiples est identique à la procédure d'ajout. Cependant, contrairement à l'ajout de valeurs, vous devez supprimer les valeurs une par une. Supposons encore que la propriété BlockedRecipients contient les valeurs indiquées dans la première section de cette rubrique.

Vous devez d'abord affecter l'objet que vous souhaitez modifier à une variable, comme dans l'exemple suivant.

$Example = Get-RecipientFilterConfig

Puis, exécutez la commande suivante qui spécifie la valeur exacte à supprimer.

$Example.BlockedRecipients -= "david@contoso.com"

Enfin, enregistrez l'objet stocké dans la variable comme suit.

Set-RecipientFilterConfig -BlockedRecipients $Example.BlockedRecipients

Exemples d'ajout de valeurs à des propriétés à valeurs multiples

Les procédures suivantes de l'environnement de ligne de commande Exchange Management Shell illustrent comment ajouter des valeurs à des propriétés à valeurs multiples disponibles sur différents objets dans Microsoft Exchange Server 2010 et montrent les résultats mis à jour.

Cet exemple ajoute une adresse SMTP à la boîte aux lettres de Rosalie Mignon.

$Mailbox = Get-Mailbox "Kim Akers"
$Mailbox.EmailAddresses += "kim@contoso.com"
Set-Mailbox "Kim Akers" -EmailAddresses $Mailbox.EmailAddresses

Cet exemple extrait le nom et les adresses de messagerie de la boîte aux lettres mise à jour de Rosalie Mignon.

Get-Mailbox "Kim Akers" | Format-List Name, EmailAddresses

Cet exemple ajoute des codes de notification d'état de remise (DSN) sur la propriété GenerateCopyOfDSNFor.

$DsnList = Get-TransportConfig
$DsnList.GenerateCopyOfDSNFor += "5.4.7", "5.7.1", "5.7.2"
Set-TransportConfig -GenerateCopyOfDSNFor $DsnList.GenerateCopyOfDSNFor

Cet exemple extrait les codes de notification d'état de remise (DSN), y compris les codes ajoutés.

Get-TransportConfig | Format-List GenerateCopyOfDSNFor

Exemples de suppression de valeurs dans des propriétés à valeurs multiples

Les procédures suivantes illustrent comment supprimer des valeurs de propriétés à valeurs multiples disponibles sur différents objets dans Exchange 2010 et montrent les résultats mis à jour.

Cet exemple supprime l'ID d'un périphérique Microsoft Exchange ActiveSync d'une boîte aux lettres d'un serveur d'accès au client.

$CasDevice = Get-CasMailbox "David Simpson"
$CasDevice.ActiveSyncAllowedDeviceIDs -= "4B9207650054767AD0AEE83A414BCD7F"
Set-CasMailbox "David Simpson" -ActiveSyncAllowedDeviceIDs $CasDevice.ActiveSyncAllowedDeviceIDs

Cet exemple extrait la liste mise à jour des ID de périphérique.

Get-CasMailbox "David Simpson" | Format-List Name, ActiveSyncAllowedDeviceIDs

Cet exemple supprime une boîte aux lettres de la liste des boîtes aux lettres disposant d'autorisations « Envoyer de la part de » sur le groupe de distribution Groupe de ventes.

$DistributionGroup = Get-DistributionGroup "Sales Group"
$DistributionGroup.GrantSendOnBehalfTo -= (Get-Mailbox "Christine Koch").Identity
Set-DistributionGroup "Sales Group" -GrantSendOnBehalfTo $DistributionGroup.GrantSendOnBehalfTo

Cet exemple extrait la liste mise à jour des boîtes aux lettres disposant d'autorisations « Envoyer de la part de » sur le groupe de distribution Groupe de ventes.

Get-DistributionGroup "Sales Group" | Format-List Name, GrantSendOnBehalfTo