Freigeben über

  • Artikel

Set-CsAllowedDomain

 

Letztes Änderungsdatum des Themas: 2012-03-27

Ändert die Eigenschaftswerte für eine oder mehrere Domänen, die in Liste der für den Partnerverbund genehmigten Domänen enthalten sind. Nachdem eine Domäne für den Partnerverbund (durch Hinzufügen zur Zulassungsliste) genehmigt wurde, können die Benutzer Sofortnachrichten und Anwesenheitsinformationen mit Personen austauschen, die über ein Konto in der Partnerdomäne verfügen.

Syntax

Set-CsAllowedDomain [-Identity <XdsGlobalRelativeIdentity>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-MarkForMonitoring <$true | $false>] [-ProxyFqdn <String>] [-WhatIf [<SwitchParameter>]]

Set-CsAllowedDomain [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MarkForMonitoring <$true | $false>] [-ProxyFqdn <String>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Ein Partnerverbund ist eine Möglichkeit, mit der zwei Organisationen eine Vertrauensstellung einrichten können, die die Kommunikation zwischen den beiden Gruppen erleichtert. Wenn ein Partnerverbund eingerichtet wurde, können Benutzer in beiden Organisationen einander Sofortnachrichten senden, Anwesenheitsbenachrichtigungen abonnieren und mithilfe von SIP-Anwendungen wie Microsoft Lync 2010 miteinander kommunizieren. Microsoft Lync Server 2010 bietet drei Arten des Partnerverbunds: 1) direkter Partnerverbund zwischen Ihrer und einer anderen Organisation, 2) Partnerverbund zwischen Ihrer Organisation und einem öffentlichen Anbieter und 3) Partnerverbund zwischen Ihrer Organisation und einem externen Hostinganbieter.

Das Einrichten eines direkten Partnerverbunds mit einer anderen Organisation ist mit mehreren Aufgaben verbunden. Zunächst müssen Sie die Server, auf denen der Lync Server-Zugriffs-Edgedienst ausgeführt wird, für den Partnerverbund aktivieren. Außerdem muss die andere Organisation den Partnerverbund mit Ihnen zulassen. Ein Partnerverbund kann nur eingerichtet werden, wenn beide Parteien mit der Partnerverbundbeziehung einverstanden sind.

Zur Einrichtung einer Partnerverbundbeziehung ist möglicherweise auch die Verwaltung von zwei partnerverbundbezogenen Listen erforderlich: Zulassungsliste und Blockierliste. Die Zulassungsliste stellt die Organisationen dar, mit denen Sie einen Partnerverbund einrichten möchten. Wenn eine Domäne in der Zulassungsliste angezeigt wird, können Ihre Benutzer (je nach den Konfigurationseinstellungen) Sofortnachrichten und Anwesenheitsinformationen mit Benutzern austauschen, die über ein Konto in dieser Partnerdomäne verfügen. Die Blockierliste enthält Domänen, mit denen der Partnerverbund ausdrücklich untersagt ist. Nachrichten, die von einer blockierten Domäne gesendet werden, werden automatisch von Lync Server 2010 abgelehnt.

Das Cmdlet Set-CsAllowedDomain bietet eine Möglichkeit, Eigenschaftswerte für eine Domäne in der Liste der zulässigen Domänen zu ändern.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Set-CsAllowedDomain lokal auszuführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAllowedDomain"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Zeichenfolge

Vollqualifizierter Domänenname (FQDN) der zulässigen Domäne, für die die Eigenschaftswerte geändert werden. Beispiel:

-Identity fabrikam.com

Instance

Optional

Blocked Domain-Objekt

Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen.

Comment

Optional

Zeichenfolge

Optionaler Zeichenfolgenwert, der zusätzliche Informationen zur zu ändernden Domäne bietet. Sie könnten beispielsweise einen Kommentar hinzufügen, der Kontaktinformationen für die Partnerdomäne enthält.

MarkForMonitoring

Optional

Boolescher Wert

Gibt an, ob die Partnerverbundverbindung zwischen Ihrer Domäne und der Remotedomäne vom Monitoring Server überwacht wird. "MarkForMonitoring" ist standardmäßig auf "False" festgelegt, d. h. die Verbindung wird nicht überwacht.

Diese Eigenschaft wird ignoriert, wenn Sie den Monitoring Server nicht bereitgestellt haben.

ProxyFqdn

Optional

Fqdn

Vollqualifizierter Domänenname (z. B. "proxy-server.fabrikam.com") des bereitgestellten SIP-Proxyservers in der Domäne, die der Zulassungsliste hinzugefügt wird. Diese Eigenschaft ist optional: Wenn sie nicht angegeben wird, wird der Standort des SIP-Proxyservers mithilfe von DNS-SRV-Ermittlungsverfahren ermittelt.

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

WhatIf

Optional

Switch-Parameter

Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.

Confirm

Optional

Switch-Parameter

Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf.

Eingabetypen

Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain-Objekt. Set-CsAllowedDomain akzeptiert weitergeleitete Instanzen des Objekts für zulässige Domänen.

Rückgabetypen

Set-CsAllowedDomain gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain" konfiguriert.

Beispiel

-------------------------- Beispiel 1 ------------------------

Set-CsAllowedDomain -Identity fabrikam.com -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)"

Der Befehl in Beispiel 1 ändert die Eigenschaft "Comment" für die zulässige Domäne mit der Identität "fabrikam.com". Hierzu werden der Parameter "Comment " und der entsprechende Parameterwert hinzugefügt: "Contact: Ken Myer (kenmyer@fabrikam.com)".

-------------------------- Beispiel 2 ------------------------

Get-CsAllowedDomain -Filter *fabrikam* | Set-CsAllowedDomain -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)" -MarkForMonitoring $True

Mit dem vorstehenden Befehl werden die Eigenschaften "Comment" und "MarkForMonitoring" für alle zulässigen Domänen geändert, deren Identitätswert die Zeichenfolge "fabrikam" enthält. Hierzu ruft der Befehl zunächst Get-CsAllowedDomain mit dem Parameter "Filter" auf. Mit dem Filterwert "*fabrikam*" weisen Sie Get-CsAllowedDomain an, alle Domänen zurückzugeben, deren Identitätswert die Zeichenfolge "fabrikam" enthält. (Dieser Befehl gibt beispielsweise Domänen wie "fabrikam.com", "us.fabrikam.net" und "fabrikam-users.org" zurück.) Die gefilterte Auflistung wird dann an das Cmdlet Set-CsAllowedDomain weitergeleitet, das für jedes Element in der Auflistung die Eigenschaft "Comment" ändert und die Eigenschaft "MarkForMonitoring" auf "True" ($True) festlegt.

-------------------------- Beispiel 3 ------------------------

Get-CsAllowedDomain | Where-Object {$_.MarkForMonitoring -eq $False} | Set-CsAllowedDomain -MarkForMonitoring $True

Der Befehl in Beispiel 3 ändert alle Domänen in der Zulassungsliste, die derzeit nicht vom Monitoring Server überwacht werden. (Das heißt alle Domänen, bei denen die Eigenschaft "MarkForMonitoring" den Wert "False" aufweist.) Dazu wird zunächst Get-CsAllowedDomain ohne Parameter aufgerufen, um eine Auflistung aller Domänen in der Liste der zulässigen Domänen zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Domänen herausfiltert, bei denen die Eigenschaft "MarkedForMonitoring" den Wert "False" aufweist. Die gefilterte Auflistung wird dann an das Cmdlet Set-CsAllowedDomain weitergeleitet, das den Wert der Eigenschaft "MarkForMonitoring" für jede Domäne in der Auflistung auf "True" festlegt.

-------------------------- Beispiel 4 ------------------------

Get-CsAllowedDomain | Where-Object {$_.Comment -eq $Null} | Set-CsAllowedDomain -Comment "Need contact information."

In Beispiel 4 wird jeder Domäne in der Liste der genehmigten Domänen, bei denen die Eigenschaft "Comment" derzeit keinen Wert aufweist, ein generischer Kommentar ("Need contact information") hinzugefügt. Dazu ruft der Befehl zunächst Get-CsAllowedDomain auf, um eine Auflistung aller Domänen in der Liste der zulässigen Domänen abzurufen. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Domänen herausfiltert, bei denen die Eigenschaft "Comment" einen Nullwert aufweist. Die gefilterte Auflistung wird dann an das Cmdlet Set-CsAllowedDomain weitergeleitet, das den Wert der Eigenschaft "Comment" für jedes Element in der Auflistung ändert.