Modification de propriétés à valeurs multiples

  • Article

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Dernière rubrique modifiée : 2007-08-13

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.

Qu'est-ce qu'une propriété à valeurs multiples ?

Une propriété à valeurs multiples est une propriété qui peut contenir plusieurs valeurs. Par exemple, la propriété BlockedRecipients de l’objet RecipientFilterConfig accepte plusieurs adresses de destinataires, comme dans les exemples suivants :

  • john@contoso.com

  • kim@northwindtraders.com

  • david@adatum.com

Étant donné que la propriété BlockedRecipients accepte plusieurs valeurs, elle est appelée « propriété à valeurs multiples ».

Pour plus d'informations sur les objets, consultez la rubrique Données structurées.

En quoi la modification d’une propriété à valeurs multiples est-elle différente ?

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. Dans ce dernier cas, vous pouvez directement lui attribuer 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 pas problème pour des propriétés n’acceptant qu’une valeur. Cependant, les propriétés à valeurs multiples posent un problème. 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, vous obtenez le résultat suivant :

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

Supposons à présent que vous avez reçu une demande d’ajout d’adresse SMTP (Single Simple Mail Transfer Protocol) à la liste de destinataires bloqués. Vous exécutez la commande suivante pour ajouter la nouvelle adresse SMTP :

Set-RecipientFilterConfig -BlockedRecipients chris@contoso.com

Lorsque vous exécutez à nouveau la commande Get-RecipientFilterConfig | Format-List BlockedRecipients, ce qui suit apparaît :

BlockedRecipients : {chris@contoso.com}

Vous n’obtenez pas le résultat escompté. 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 les procédures de modification de propriétés à valeurs multiples et de propriétés n’acceptant qu’une seule valeur. Lorsque vous modifiez une propriété à valeurs multiples, veillez à ajouter ou supprimer les valeurs, plutôt que de remplacer l’ensemble de la liste de valeurs. Les sections suivantes vous indiquent comment effectuer cette opération exactement.

Notes

Certaines cmdlets, telles que Set-TransportRule, >, ne prennent pas en charge la modification de propriétés d’objets telle que la décrit 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 avoir compris les concepts suivants :

Procédure d’ajout d’une valeur à une propriété à valeurs multiples

La procédure d’ajout d’une valeur à une propriété à valeurs multiples est très simple. Elle ne requiert que quelques étapes supplémentaires. Supposons encore que la propriété BlockedRecipients contient les valeurs indiquées dans la première section.

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

$Example = Get-RecipientFilterConfig

Lorsque vous exécutez la commande $Example | Format-List BlockedRecipients, vous obtenez le résultat suivant :

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

Vous devez ensuite ajouter la valeur à ajouter à la propriété BlockedRecipients sur l’objet stocké dans la variable $Example. Notez que cette étape ne fait qu’ajouter la valeur à l’objet stocké dans la variable. Pour ajouter chris@contoso.com à la propriété BlockedRecipients sur un objet stocké dans la variable $Example, exécutez la commande suivante :

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

Lorsque vous exécutez à nouveau la commande $Example | Format-List BlockedRecipients, vous obtenez le résultat suivant :

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

Comme vous pouvez le voir, l’adresse SMTP chris@contoso.com a été ajoutée à la liste de valeurs stockées dans la propriété BlockedRecipients property.

Vous devez finalement enregistrer l’objet 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, il apparaît que l’adresse SMTP chris@contoso.com a bien été 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 de la façon décrite ci-dessus. Lorsque vous spécifiez des valeurs à ajouter, séparez-les par des virgules 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, utilisez la cmdlet Set-RecipientFilterConfig pour enregistrer l’objet.

Notes

Certaines cmdlets n’acceptent pas l’ajout simultané de plusieurs valeurs.

Procédure de suppression d’une valeur d'une propriété à valeurs multiples

Vous pouvez avoir besoin de supprimer une seule valeur dans une propriété à valeurs multiples, et non toutes les valeurs à 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.

Vous devez tout d’abord attribuer l’objet à modifier à une variable, comme dans l’exemple suivant :

$Example = Get-RecipientFilterConfig

Il vous faut ensuite exécuter 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 la procédure d’ajout de valeurs à certaines des propriétés à valeurs multiples disponibles sur plusieurs objets dans Microsoft Exchange Server 2007.

Ajout d'une adresse SMTP à une boîte aux lettres

  1. Exécutez les commandes suivantes :

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

  2. Pour afficher la boîte aux lettres actualisée, exécutez la commande suivante :

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

Ajout de codes DSN supplémentaires à la propriété GenerateCopyOfDSNFor

  1. Exécutez les commandes suivantes :

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

  2. Pour afficher les codes de notification d'état de remise actualisés, exécutez la commande suivante :

    Get-TransportConfig | Format-List GenerateCopyOfDSNFor

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

Les procédures suivantes illustrent la procédure de suppression de valeurs dans certaines des propriétés à valeurs multiples disponibles sur plusieurs objets dans Exchange 2007.

Suppression de l’ID de périphérique d’un périphérique Exchange ActiveSync activé dans une boîte aux lettres CAS (serveur d’accès au client)

  1. Exécutez les commandes suivantes

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

  2. Pour afficher la boîte aux lettre CAS actualisée, exécutez la commande suivante :

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

Suppression d’une boîte aux lettres de la liste de boîtes aux lettres habilitées à « envoyer au nom de » dans un groupe de distribution

  1. Exécutez la commande suivante :

    $DistributionGroup = Get-DistributionGroup "Sales Group"
$DistributionGroup.GrantSendOnBehalfTo -= (Get-Maibox "Christine Hughes").Identity
Set-DistributionGroup "Sales Group" -GrantSendOnBehalfTo $DistributionGroup.GrantSendOnBehalfTo

  2. Pour afficher le groupe de distribution actualisé, exécutez la commande suivante :

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

Pour plus d'informations

Pour plus d'informations sur les fonctions abordées dans cette rubrique, consultez les rubriques suivantes :