Freigeben über

  • Artikel

New-CsPublicProvider

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt eine Partnerverbundbeziehung mit einem neuen öffentlichen Anbieter. Ein öffentlicher Anbieter ist eine Organisation, die Instant Messaging-, Anwesenheits- und ähnliche Dienste für die breite Öffentlichkeit bietet. Microsoft Lync Server 2010 umfasst drei öffentliche Anbieter, die zwar bereits konfiguriert, aber noch nicht aktiviert sind: Yahoo!, AOL und MSN.

Syntax

New-CsPublicProvider -Identity <XdsGlobalRelativeIdentity> -Enabled <$true | $false> -ProxyFqdn <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-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. 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.

Ein öffentlicher Anbieter ist eine Organisation, die SIP-Kommunikationsdienste für die breite Öffentlichkeit bietet. Wenn Sie eine Partnerverbundbeziehung mit einem öffentlichen Anbieter einrichten, stellen Sie im Prinzip einen Partnerverbund mit allen Benutzern her, deren Konto von diesem Anbieter gehostet wird. Bei einem Partnerverbund mit MSN können Benutzer Sofortnachrichten und Anwesenheitsinformationen mit allen anderen Benutzern austauschen, die über ein Instant Messaging-Konto für MSN verfügen.

Um mit einem öffentlichen Anbieter im Partnerverbund zu arbeiten, müssen Sie einen neuen öffentlichen Anbieter erstellen und aktivieren. (Darüber hinaus muss der öffentliche Anbieter eine Partnerverbundbeziehung mit Ihnen einrichten.) Mit dem Cmdlet Set-CsPublicProvider können Sie Eigenschaftswerte für alle öffentlichen Anbieter ändern, die für die Verwendung in Ihrer Organisation konfiguriert sind.

Beachten Sie, dass ein Partnerverbund mit einem öffentlichen Anbieter nicht möglich ist, wenn die Konfiguration der Edgeserver nicht das DNS-Serverrouting, sondern das Standardrouting vorsieht.

Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig dürfen Mitglieder der folgenden Gruppen das Cmdlet New-CsPublicProvider lokal ausfü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-CsPublicProvider"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Zeichenfolge

Eindeutige ID für den zu erstellenden öffentlichen Anbieter. Als Identitätswert wird in der Regel der Name der Website verwendet, die die Dienste bereitstellt (z. B. Yahoo!, AOL oder MSN).

Identitäten müssen nicht nur unter öffentlichen Anbietern, sondern auch unter Hostinganbietern eindeutig sein. Angenommen, Sie versuchen, einen neuen öffentlichen Anbieter mit dem Identitätswert "Fabrikam" zu erstellen. Bei dem Befehl tritt ein Fehler auf, wenn es bereits einen öffentlichen Anbieter oder Hostinganbietern mit dieser Identität gibt.

ProxyFqdn

Erforderlich

FQDN

Gibt den vollqualifizierten Domänennamen (z. B. "proxyserver.fabrikam.com") des vom öffentlichen Anbieter verwendeten Proxyservers an.

Proxy-FQDNs müssen nicht nur unter öffentlichen Anbietern, sondern auch unter Hostinganbietern eindeutig sein. Angenommen, Sie versuchen einen neuen öffentlichen Anbieter mit dem Proxy-FQDN "proxyserver.fabrikam.com" zu erstellen. Bei diesem Befehl tritt ein Fehler auf, wenn es bereits einen öffentlichen Anbieter oder Hostinganbieter mit diesem Proxy-FQDN gibt.

Enabled

Erforderlich

Boolescher Wert

Gibt an, ob die Partnerverbundbeziehung zwischen Ihrer Organisation und dem öffentlichen Anbieter aktiv ist. Ist der Parameter auf "True" festgelegt, können Benutzer in der Organisation Sofortnachrichten und Anwesenheitsinformationen mit Benutzern austauschen, deren Konten vom öffentlichen Anbieter gehostet werden. Ist er auf "False" festgelegt, können Benutzer in der Organisation keine Sofortnachrichten und Anwesenheitsinformationen mit Benutzern austauschen, deren Konten vom öffentlichen Anbieter gehostet werden. Sie können Partnerverbundbeziehungen jederzeit mit den Cmdlets Enable-CsPublicProvider und Disable-CsPublicProvider aktivieren bzw. deaktivieren.

VerificationLevel

Zeichenfolge

Gibt an, wie (oder ob) von einem öffentlichen Anbieter gesendete Nachrichten überprüft werden, um sicherzustellen, dass sie tatsächlich von diesem Anbieter stammen. Die Eigenschaft "VerificationLevel" muss auf einen der folgenden Werte festgelegt werden:

"AlwaysVerifiable". Alle Nachrichten, die von diesem Anbieter zu stammen scheinen, werden akzeptiert. Wird in der Nachricht kein Überprüfungsheader gefunden, wird er von Lync Server 2010 hinzugefügt. Dies ist der Standardwert.

"AlwaysUnverifiable". Alle Nachrichten, die von diesem Anbieter zu stammen scheinen, werden als nicht überprüft angesehen, Sie werden nur zugestellt, wenn sie von einer in der Kontaktliste des Empfängers enthaltenen Person gesendet wurden. Wenn "Ken Myer" beispielsweise in Ihrer Kontaktliste enthalten ist, können Sie Nachrichten von ihm erhalten. Wenn "Pilar Ackerman" dagegen nicht in Ihrer Kontaktliste enthalten ist, können Sie keine Nachrichten von ihr erhalten.

"UseSourceVerification". Verwendet den vom öffentlichen Anbieter in der Nachricht hinzugefügten Überprüfungsheader. Fehlen die Überprüfungsinformationen, wird die Nachricht abgelehnt.

Force

Switch-Parameter

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

InMemory

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

Switch-Parameter

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

Confirm

Switch-Parameter

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

Eingabetypen

Keine. New-CsPublicProvider akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Erstellt neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider".

Beispiel

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

New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True

Der Befehl in Beispiel 1 erstellt eine neue Partnerverbundbeziehung mit einem öffentlichen Anbieter, der den Identitätswert "Fabrikam" aufweist. Neben dem Identitätswert müssen zwei Eigenschaftswerte (und die zugehörigen Parameter) festgelegt werden: "ProxyFqdn" (auf "proxyserver.fabrikam.com" festgelegt) und "Enabled" (in diesem Fall auf "True" festgelegt).

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

$x = New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True -InMemory
$x.VerificationLevel = "AlwaysUnverifiable"
Set-CsPublicProvider -Instance $x

In Beispiel 2 wird veranschaulicht, wie Sie einen neuen öffentlichen Anbieter nur im Arbeitsspeicher erstellen, die Eigenschaften dieses Anbieters ändern und den virtuellen Anbieter in einen tatsächlichen Anbieter umwandeln können, der in Ihrer Organisation verwendet werden kann. Dazu erstellt der erste Befehl einen öffentlichen Anbieter mit dem Identitätswert "Fabrikam". Zusätzlich zu den erforderlichen Parametern ("Identity", "ProxyFqdn" und "Enabled") fügt der Befehl den Parameter "InMemory" hinzu. Damit wird eine nur im Arbeitsspeicher vorhandene Instanz des Anbieters erstellt, die anschließend in der Variablen "$x" gespeichert wird.

Nachdem die im Arbeitsspeicher vorhandene Instanz des Anbieters erstellt wurde, wird mit dem Befehl im zweiten Beispiel der Wert von "VerificationLevel" für den virtuellen Anbieter geändert. Der letzte Befehl verwendet dann Set-CsPublicProvider, um den (in "$x gespeicherten) virtuellen Anbieter in einen tatsächlichen öffentlichen Anbieter umzuwandeln. Wenn Sie Set-CsPublicProvider nicht aufrufen, wird der tatsächliche Anbieter nicht erstellt. Der virtuelle Anbieter geht verloren, sobald Sie die Windows PowerShell-Sitzung beenden oder die Variable "$x" löschen.