New-CsAllowedDomain

Syntax

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

New-CsAllowedDomain -Domain <String> [-Comment <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 partnververbundbezogenen Listen erforderlich: Zulassungsliste und Blockierliste. Die Zulassungsliste enthält die Organisationen, mit denen Sie im Partnerverbund stehen. Wenn eine Domäne in dieser Liste angezeigt wird, können Ihre Benutzer (je nach den Konfigurationseinstellungen) Sofortnachrichten und Anwesenheitsinformationen mit Benutzern austauschen, die über ein Konto in der 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.

Zum Erstellen einer neuen Partnerverbundbeziehung kann New-CsAllowedDomain verwendet werden, um eine Domäne zur Liste der zulässigen Domänen hinzuzufügen.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet New-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 "New-CsAllowedDomain"}

Parameter

Eingabetypen

Keine. New-CsAllowedDomain akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Erstellt eine Instanz des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.AllowedDomain".

Beispiel

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

New-CsAllowedDomain -Identity "fabrikam.com"

Im vorstehenden Beispiel wird die Domäne "fabrikam.com" der Liste der zulässigen Domänen hinzugefügt. Dazu wird New-CsAllowedDomain zusammen mit dem Parameter "Identity" aufgerufen. Diesem Parameter wird der Name der Domäne zugewiesen, die der Zulassungsliste hinzugefügt werden soll. Beachten Sie, dass bei diesem Befehl ein Fehler auftritt, wenn "fabrikam.com" bereits in der Zulassungsliste oder in der Blockierliste enthalten ist.

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

New-CsAllowedDomain -Identity "fabrikam.com" -ProxyFqdn "proxyserver.fabrikam.com" -MarkForMonitoring $True -Comment "Contact: Ken Myer (kenmyer@fabrikam.com)"

Beispiel 2 ist eine Variante des Befehls in Beispiel 1. In diesem Fall werden zusätzlich zu "Identity" jedoch zwei weitere Parameter aufgenommen: "ProxyFqdn" wird verwendet, um den vollqualifizierten Domänennamen des Proxyservers für "fabrikam.com" anzugeben, und "MarkForMonitoring" wird zum Hinzufügen dieser Partnerverbundverbindung zur Liste der Elemente hinzugefügt, die vom Monitoring Server überwacht werden.

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

$x = New-CsAllowedDomain -Identity "fabrikam.com" -InMemory
$x.ProxyFqdn = "proxyserver.fabrikam.com" 
$x.MarkForMonitoring = $True 
$x.Comment = "Contact: Ken Myer (kenmyer@fabrikam.com)"
Set-CsAllowedDomain -Instance $x

Beispiel 3 zeigt, wie Sie mit dem Parameter "InMemory" eine neue zulässige Domäne erstellen können, die zunächst nur im Arbeitsspeicher vorhanden ist. Nach dem Ändern der Eigenschaftswerte dieser nur im Arbeitsspeicher vorhandenen Domäne können Sie das Cmdlet Set-CsAllowedDomain aufrufen, um die Domäne der Zulassungsliste hinzuzufügen.

Hierzu verwendet der erste Befehl im Beispiel das Cmdlet New-CsAllowedDomain und den Parameter "InMemory", um eine zulässige Domäne mit der Identität "fabrikam.com" zu erstellen. Anschließend wird diese virtuelle Domäne in der Variablen "$x" gespeichert.

In den Zeilen 2, 3 und 4 werden die Werte der Eigenschaften "ProxyFqdn", "MarkForMonitoring" und "Comment" geändert. Nach dem Ändern aller Eigenschaftswerte verwendet der letzte Befehl Set-CsAllowedDomain, um die virtuelle Domäne der Liste zulässiger Domänen hinzuzufügen. Bedenken Sie, dass "fabrikam.com" bis zum Aufruf von Set-CsAllowedDomain nur im Arbeitsspeicher vorhanden ist: Wenn Get-CsAllowedDomain vor dem Befehl in der letzten Zeile des Beispiels ausgeführt wird, ist "fabrikam.com" nicht in der Liste der zulässigen Domänen enthalten. "Fabrikam.com" wird erst in der Zulassungsliste angezeigt, nachdem Sie Set-CsAllowedDomain aufgerufen haben.

Siehe auch

Weitere Ressourcen

Get-CsAllowedDomain
Remove-CsAllowedDomain
Set-CsAccessEdgeConfiguration
Set-CsAllowedDomain