Ändern von mehrwertigen Eigenschaften

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-08-13

In diesem Thema wird erläutert, wie Sie mithilfe der Exchange-Verwaltungsshell Werte zu einer mehrwertigen Eigenschaft eines Objekts hinzufügen bzw. Werte aus einer mehrwertigen Eigenschaft einer entfernen.

Was ist eine mehrwertige Eigenschaft?

Eine mehrwertige Eigenschaft ist eine Eigenschaft, die mehr als einen Wert enthalten kann. Die Eigenschaft BlockedRecipients des Objekts RecipientFilterConfig kann beispielsweise mehrere Empfängeradressen enthalten, wie nachfolgend dargestellt:

  • john@contoso.com

  • kim@northwindtraders.com

  • david@adatum.com

Da die Eigenschaft BlockedRecipients mehrere Werte akzeptiert, wird sie als mehrwertige Eigenschaft bezeichnet.

Weitere Informationen zu Objekten finden Sie unter Strukturierte Daten.

Was sind die Besonderheiten beim Ändern einer mehrwertigen Eigenschaft?

Das Ändern einer mehrwertigen Eigenschaft unterscheidet sich geringfügig vom Ändern einer Eigenschaft, die nur einen Wert akzeptiert. Wenn Sie eine Eigenschaft ändern, die nur einen einzigen Wert akzeptiert, können Sie dieser Eigenschaft einen Wert direkt zuweisen, wie im folgenden Befehl dargestellt:

Set-TransportConfig -MaxSendSize 12MB

Wenn Sie der Eigenschaft MaxSendSize mit diesem Befehl einen neuen Wert zuweisen, wird der gespeicherte Wert überschrieben. Bei einwertigen Eigenschaften ist dies unproblematisch. Bei mehrwertigen Eigenschaften stellt dies jedoch ein Problem dar. Angenommen, die Eigenschaft BlockedRecipients der Eigenschaft RecipientFilterConfig ist für die drei Werte konfiguriert, die im voranstehenden Abschnitt aufgeführt sind. Wenn Sie den Befehl Get-RecipientFilterConfig | Format-List BlockedRecipients ausführen, wird Folgendes angezeigt:

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

Angenommen, Sie erhalten nun die Aufforderung, eine neue SMTP-Adresse (Simple Mail Transfer Protocol) zur Liste der geblockten Empfänger hinzuzufügen. Sie führen den folgenden Befehl aus, um die neue SMTP-Adresse hinzuzufügen:

Set-RecipientFilterConfig -BlockedRecipients chris@contoso.com

Wenn Sie den Befehl Get-RecipientFilterConfig | Format-List BlockedRecipients erneut ausführen, wird Folgendes angezeigt:

BlockedRecipients : {chris@contoso.com}

Dies ist nicht, was Sie erwartet haben. Sie wollten die neue SMTP-Adresse zur vorhandenen Liste der geblockten Empfänger hinzufügen, stattdessen wurde die vorhandene Liste der geblockten Empfänger durch die neue SMTP-Adresse ersetzt. Dies ist der Unterschied beim Ändern mehrwertiger und einwertiger Eigenschaften. Wenn Sie eine mehrwertige Eigenschaft ändern, müssen Sie sicherstellen, dass Werte hinzugefügt, bzw. einzelne Werte entfernt werden und nicht die gesamte Werteliste überschrieben wird. In den folgenden Abschnitten wird veranschaulicht, die Sie genau dies tun.

Hinweis

Einige Cmdlets, z. B. Set-TransportRule, unterstützen das in diesem Thema beschriebene Vorgehen zum Ändern von Eigenschaften für Objekte nicht. Weitere Informationen dazu, wie Sie Werte zu mehrwertigen Eigenschaften dieser Cmdlets hinzufügen bzw. daraus entfernen, finden Sie in den Themen zu diesen Cmdlets, z. B. Set-TransportRule.

Zum Ändern mehrwertiger Eigenschaften müssen Sie die folgenden Konzepte verstehen:

Hinzufügen eines Werts zu einer mehrwertigen Eigenschaft

Es ist ganz einfach, einen Wert zu einer mehrwertigen Eigenschaft hinzuzufügen. Dazu benötigen Sie nur wenige Schritte. Nehmen Sie wieder an, dass die Eigenschaft BlockedRecipients die Werte enthält, die im ersten Abschnitt aufgeführt wurden.

Zuerst müssen Sie das Objekt abrufen, das Sie ändern möchten, und es einer Variablen zuweisen. Wenn Sie beispielsweise der Variablen $Example das Objekt RecipientFilterConfig zuweisen möchten, verwenden Sie hierfür den folgenden Befehl:

$Example = Get-RecipientFilterConfig

Wenn Sie den Befehl $Example | Format-List BlockedRecipients ausführen, wird Folgendes zurückgegeben:

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

Als Nächstes müssen Sie den Wert angeben, den Sie zur Eigenschaft BlockedRecipients für das Objekt in der Variablen $Example hinzufügen möchten. Beachten Sie, dass dieser Schritt den Wert nur zu dem in der Variablen gespeicherten Objekt hinzufügt. Um chris@contoso.com zur Eigenschaft BlockedRecipients für das Objekt in der Variablen $Example hinzuzufügen, führen Sie den folgenden Befehl aus:

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

Wenn Sie den Befehl $Example | Format-List BlockedRecipients erneut ausführen, wird Folgendes zurückgegeben:

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

Wie Sie sehen, wurde die SMTP-Adresse chris@contoso.com zur Liste der in der Eigenschaft BlockedRecipients gespeicherten Werte hinzugefügt.

Schließlich müssen Sie das in $Example enthaltene Objekt mit dem folgenden Befehl speichern:

Set-RecipientFilterConfig -BlockedRecipients $Example.BlockedRecipients

Wenn Sie jetzt den Befehl Get-RecipientFilterConfig | Format-List BlockedRecipients ausführen, werden Sie feststellen, dass die SMTP-Adresse chris@contoso.com zum Server hinzugefügt wurde.

Hinzufügen mehrerer Werte zu einer mehrwertigen Eigenschaft

Zum gleichzeitigen Hinzufügen mehrerer Werte zu einer mehrwertigen Eigenschaft führen Sie dieselben Schritte wie oben beschrieben aus. Beim Angeben der Werte, die Sie hinzufügen möchten, trennen Sie diese durch Kommas, wie im folgenden Beispiel dargestellt:

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

Nachdem Sie die gewünschten Werte angegeben haben, speichern Sie das Objekt mithilfe des Cmdlets Set-RecipientFilterConfig.

Hinweis

Mit einigen Cmdlets können Sie nicht mehrere Werte gleichzeitig hinzufügen.

Entfernen eines Werts aus einer mehrwertigen Eigenschaft

Es kann vorkommen, dass Sie einen einzelnen Wert aus einer mehrwertigen Eigenschaft entfernen möchten, ohne die übrigen Werte zu löschen. Das Entfernen eines einzelnen Werts aus einer mehrwertigen Eigenschaft gleicht dem Hinzufügen eines Werts. Sie können allerdings nicht mehrere Werte gleichzeitig entfernen. Nehmen Sie wieder an, dass die Eigenschaft BlockedRecipients die Werte enthält, die im ersten Abschnitt aufgeführt wurden.

Zuerst weisen Sie das zu ändernde Objekt einer Variablen zu, wie im folgenden Beispiel dargestellt:

$Example = Get-RecipientFilterConfig

Führen Sie dann den folgenden Befehl aus, der den genauen Wert angibt, der entfernt werden soll:

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

Speichern Sie schließlich das in der Variablen enthaltene Objekt wie folgt:

Set-RecipientFilterConfig -BlockedRecipients $Example.BlockedRecipients

Beispiele für das Hinzufügen von Werten zu mehrwertigen Eigenschaften

Die folgenden Exchange-Verwaltungsshellverfahren sind Beispiele für das Hinzufügen von Werten zu einigen der mehrwertigen Eigenschaften, die für verschiedene Objekte in Microsoft Exchange Server 2007 verfügbar sind.

So fügen Sie eine SMTP-Adresse zu einem Postfach hinzu

  1. Führen Sie die folgenden Befehle aus:

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

  2. Führen Sie den folgenden Befehl aus, um das aktualisierte Postfach anzuzeigen:

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

So fügen Sie zusätzliche DSN-Codes (Delivery Status Notification, Benachrichtigung über den Übermittlungsstatus) zur Eigenschaft "GenerateCopyOfDSNFor" hinzu

  1. Führen Sie die folgenden Befehle aus:

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

  2. Führen Sie den folgenden Befehl aus, um die aktualisierten DSN-Codes anzuzeigen:

    Get-TransportConfig | Format-List GenerateCopyOfDSNFor

Beispiele für das Entfernen von Werten aus mehrwertigen Eigenschaften

Die folgenden Verfahren sind Beispiele für das Entfernen von Werten aus einigen der mehrwertigen Eigenschaften, die für verschiedene Objekte in Exchange 2007 verfügbar sind.

So entfernen Sie die Geräte-ID eines aktivierten Exchange ActiveSync-Geräts von einem Clientzugriffsserver-Postfach

  1. Führen Sie die folgenden Befehle aus

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

  2. Führen Sie den folgenden Befehl aus, um das aktualisierte Clientzugriffsserver-Postfach anzuzeigen:

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

So entfernen Sie ein Postfach aus einer Liste von Postfächern, die über die Berechtigung "Senden im Auftrag von" für eine Verteilergruppe verfügen

  1. Führen Sie den folgenden Befehl aus:

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

  2. Führen Sie den folgenden Befehl aus, um die aktualisierte Verteilergruppe anzuzeigen:

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

Weitere Informationen

Weitere Informationen zu den in diesem Thema behandelten Features finden Sie unter den folgenden Themen: