Ändern von mehrwertigen Eigenschaften

  • Artikel

Gilt für: Exchange Server 2013

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 BlockedRecipients-Eigenschaft mehr als einen Wert akzeptieren kann, wird sie als mehrwertige Eigenschaft bezeichnet. In diesem Thema wird erläutert, wie Sie mit der Exchange-Verwaltungsshell Werte zu einer mehrwertigen Eigenschaft für ein Objekt hinzufügen und daraus entfernen.

Weitere Informationen zu Objekten finden Sie unter Strukturierte Daten. Weitere Informationen zur Shell finden Sie unter Verwenden von PowerShell mit Exchange 2013 (Exchange-Verwaltungsshell).

Ändern mehrwertiger Eigenschaften im Vergleich zum Ändern einwertiger Eigenschaften

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 des Objekts RecipientFilterConfig ist mit den drei Werten konfiguriert, die im vorherigen Abschnitt aufgeführt sind. Wenn Sie den Befehl Get-RecipientFilterConfig | Format-List BlockedRecipientsausführen, wird Folgendes angezeigt.

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

Angenommen, Sie werden nun gebeten, eine neue SMTP-Adresse zur Liste der blockierten Empfänger hinzuzufügen. Um die neue SMTP-Adresse hinzuzufügen, führen Sie den folgenden Befehl aus.

Set-RecipientFilterConfig -BlockedRecipients chris@contoso.com

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

BlockedRecipients : {chris@contoso.com}

Dies ist nicht das, was Sie erwartet haben. Sie wollten die neue SMTP-Adresse der vorhandenen Liste blockierter Empfänger hinzufügen, aber stattdessen wurde die vorhandene Liste der blockierten Empfänger durch die neue SMTP-Adresse überschrieben. Dieses unbeabsichtigte Ergebnis veranschaulicht, wie sich das Ändern einer mehrwertigen Eigenschaft von der Änderung einer Eigenschaft unterscheidet, die nur einen einzelnen Wert akzeptiert. Wenn Sie eine mehrwertige Eigenschaft ändern, müssen Sie sicherstellen, dass Sie Werte anfügen oder entfernen, anstatt die gesamte Liste der Werte zu überschreiben. In den folgenden Abschnitten wird gezeigt, wie Sie genau dies tun.

Ändern mehrwertiger Eigenschaften

Das Ändern mehrwertiger Eigenschaften ähnelt dem Ändern von einwertigen Eigenschaften. Sie müssen lediglich eine zusätzliche Syntax hinzufügen, um der Shell mitzuteilen, dass Sie Der mehrwertigen Eigenschaft Werte hinzufügen oder daraus entfernen möchten, anstatt alles zu ersetzen, was in der Eigenschaft gespeichert ist. Die Syntax wird zusammen mit den Werten, die der Eigenschaft hinzugefügt oder daraus entfernt werden sollen, als Wert für einen Parameter eingeschlossen, wenn Sie ein Cmdlet ausführen. Die folgende Tabelle zeigt die Syntax, die Sie einem Parameter in einem Cmdlet hinzufügen müssen, um mehrwertige Eigenschaften zu ändern.

Syntax für mehrwertige Eigenschaften

Aktion Syntax
Hinzufügen eines oder mehrerer Werte zu einer mehrwertigen Eigenschaft @{Add="<value1>", "<value2>", "<value3>"}
Entfernen eines oder mehrerer Werte aus einer mehrwertigen Eigenschaft @{Remove="<value1>", "<value2>", "<value3>"}

Die Syntax, die Sie aus der Syntaxtabelle für mehrwertige Eigenschaften auswählen, wird als Parameterwert in einem Cmdlet angegeben. Der folgende Befehl fügt einer mehrwertigen Eigenschaft beispielsweise mehrere Werte hinzu:

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

Wenn Sie diese Syntax verwenden, werden die von Ihnen angegebenen Werte der Liste der Werte hinzugefügt oder daraus entfernt, die bereits in der Eigenschaft vorhanden sind. Anhand des BlockedRecipients-Beispiels weiter oben in diesem Thema können wir nun mit dem folgenden Befehl hinzufügen, ohne die restlichen Werte für diese Eigenschaft zu chris@contoso.com überschreiben:

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

Wenn Sie aus der Liste der Werte entfernen david@adatum.com möchten, verwenden Sie diesen Befehl:

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

Komplexere Kombinationen können verwendet werden, z. B. gleichzeitiges Hinzufügen oder Entfernen von Werten zu und aus einer Eigenschaft. Fügen Sie dazu ein Semikolon (; ) zwischen Add - und Remove -Aktionen ein. Beispiel:

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

Wenn wir den Get-RecipientFilterConfig | Format-List BlockedRecipients Befehl erneut verwenden, sehen wir, dass die E-Mail-Adressen für Carter, Sam und Brian hinzugefügt wurden, während die Adresse für John entfernt wurde.

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