Freigeben über

  • Artikel

Set-CsPublicProvider

 

Letztes Änderungsdatum des Themas: 2012-03-25

Ändert einen derzeit für die Verwendung in Ihrer Organisation konfigurierten ö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

Set-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]

Set-CsPublicProvider [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 (je nach Ihren Konfigurationseinstellungen) 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.) Lync Server umfasst drei bereits vorkonfigurierte öffentliche Anbieter (Yahoo!; AOL und MSN). Wenn neue öffentliche Anbieter verfügbar werden, verwenden Sie das Cmdlet New-CsPublicProvider, um Partnerverbundbeziehungen mit diesen einzugehen. Nachdem eine Partnerverbundbeziehung eingerichtet wurde, können Sie mit dem Cmdlet Set-CsPublicProvider zwei wichtige Eigenschaftswerte ("Enabled" und "VerificationLevel") für diese Beziehungen ändern.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

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

Instance

Optional

DisplayPublicProvider-Objekt

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

Enabled

Optional

Switch-Parameter

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.

VerificationLevel

Optional

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 vorgeblich von diesem Anbieter stammen, 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 vorgeblich von diesem Anbieter stammen, 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

Optional

Switch-Parameter

Unterdrückt die Anzeige von Bestätigungsaufforderungen oder Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Cmdlets 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.DisplayPublicProvider-Objekt. Das Cmdlet Set-CsPublicProvider akzeptiert weitergeleitete Instanzen des Objekts für öffentliche Anbieter.

Rückgabetypen

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

Beispiel

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

Set-CsPublicProvider -Identity "MSN" -VerificationLevel "UseSourceVerification"

Der vorstehende Befehl legt die Eigenschaft "VerificationLevel" für den öffentlichen Anbieter auf den Identitätswert "MSN" fest. Hierzu werden der Parameter "VerificationLevel" und der Parameterwert "UseSourceVerification" hinzugefügt.

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

Get-CsPublicProvider | Set-CsPublicProvider -VerificationLevel "UseSourceVerification"

In Beispiel 2 wird die Überprüfungsstufe für alle derzeit in der Organisation verwendeten öffentlichen Anbieter geändert. Hierzu ruft der Befehl zunächst Get-CsPublicProvider ohne zusätzliche Parameter auf, um eine Auflistung aller derzeit für die Verwendung konfigurierten öffentlichen Anbieter zurückzugeben. Diese Auflistung wird dann an das Cmdlet Set-CsPublicProvider weitergeleitet, das für jeden Anbieter in der Auflistung den Wert der Eigenschaft "VerificationLevel" in "UseSourceVerification" ändert.

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

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -eq "AlwaysVerifiable"} | Set-CsPublicProvider -VerificationLevel "UseSourceVerification"

Der Befehl in Beispiel 3 ändert die Überprüfungsstufe für alle öffentlichen Anbieter mit der aktuellen Überprüfungsstufe "AlwaysVerifiable". Hierzu ruft der Befehl zunächst Get-CsPublicProvider auf, um eine Auflistung aller öffentlichen Anbieter zurückzugeben, die für die Verwendung in der Organisation konfiguriert sind. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Anbieter herausfiltert, bei denen die Eigenschaft "VerificationLevel" den Wert "AlwaysVerifiable" aufweist (der Vergleichsoperator "-eq" steht für "equal to"). Diese gefilterte Auflistung wird wiederum an das Cmdlet Set-CsPublicProvider weitergeleitet, das die Eigenschaft "VerificationLevel" für jeden Anbieter in der Auflistung in "UseSourceVerification" ändert.