Ändern von mehrwertigen Eigenschaften
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
Führen Sie die folgenden Befehle aus:
$Mailbox = Get-Mailbox "Kim Akers" $Mailbox.EmailAddresses += "kim@contoso.com" Set-Mailbox "Kim Akers" -EmailAddresses $Mailbox.EmailAddresses
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
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
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
Führen Sie die folgenden Befehle aus
$CasDevice = Get-CasMailbox "David Simpson" $CasDevice.ActiveSyncAllowedDeviceIDs -= "4B9207650054767AD0AEE83A414BCD7F" Set-CasMailbox "David Simpson" -ActiveSyncAllowedDeviceIDs $CasDevice.ActiveSyncAllowedDeviceIDs
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
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
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: