Freigeben über

  • Artikel

New-CsAllowedDomain

 

Letztes Änderungsdatum des Themas: 2012-03-23

Fügt eine Domäne zur Liste der für den Partnerverbund genehmigten Domänen hinzu. 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

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

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Vollqualifizierter Domänenname (FQDN) der Domäne, die der Zulassungsliste hinzugefügt werden soll, zum Beispiel "fabrikam.com". Sie können entweder den Parameter "Identity" oder den Parameter "Domain" (jedoch nicht beide) zum Angeben des Domänennamens verwenden. Wenn Sie "Identity" verwenden, wird die Eigenschaft "Domain" auf denselben Wert festgelegt, der "Identity" zugewiesen ist. Wenn Sie "Domain" verwenden, wird die Eigenschaft "Identity" auf denselben Wert gesetzt, der "Domain" zugewiesen ist.

Beachten Sie, dass Identitäten eindeutig sein müssen: Wenn die angegebene Domäne bereits in der Blockier- oder Zulassungsliste enthalten ist, tritt bei Ausführung des Befehls ein Fehler auf.

Comment

Optional

Zeichenfolge

Optionaler Zeichenfolgenwert, der zusätzliche Informationen zur Domäne liefert, die zur Zulassungsliste hinzugefügt wird. Sie könnten beispielsweise einen Kommentar hinzufügen, der Kontaktinformationen für die Partnerdomäne enthält.

Domain

Optional

Zeichenfolge

FQDN (zum Beispiel "fabrikam.com") der Domäne, die der Zulassungsliste hinzugefügt werden soll. Sie können zum Festlegen des Domänennamens den Parameter "Identity" oder "Domain" verwenden (aber nicht beide). Wenn Sie "Identity" verwenden, wird die Eigenschaft "Domain" auf denselben Wert festgelegt, der "Identity" zugewiesen ist. Wenn Sie "Domain" verwenden, wird die Eigenschaft "Identity" auf denselben Wert gesetzt, der "Domain" zugewiesen ist.

Beachten Sie, dass Domänen eindeutig sein müssen: Wenn die angegebene Domäne bereits in der Blockier- oder Zulassungsliste enthalten ist, tritt bei Ausführung des Befehls ein Fehler auf.

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 anhand von DNS-SRV-Erkennungsverfahren ermittelt.

Force

Optional

Switch-Parameter

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

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

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.