Freigeben über

  • Artikel

Get-CsPublicProvider

 

Letztes Änderungsdatum des Themas: 2012-03-23

Gibt Informationen zu den öffentlichen Anbietern zurück, die für die Verwendung in Ihrer Organisation konfiguriert sind. 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

Get-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsPublicProvider [-Filter <String>] [-LocalStore <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 Get-CsPublicProvider können Sie Informationen zu allen öffentlichen Anbietern zurückzugeben, die für die Verwendung in Ihrer Organisation konfiguriert sind.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

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

Sie können beim Angeben des Identitätswerts keine Platzhalter verwenden. Verwenden Sie für die Platzhaltersuche zum Zurückgeben eines oder mehrerer öffentlicher Anbieter stattdessen den Parameter "Filter".

Filter

Optional

Zeichenfolge

Ermöglicht die Verwendung von Platzhalterwerten zur Rückgabe eines oder mehrerer öffentlicher Anbieter. Verwenden Sie folgende Syntax, um beispielsweise eine Auflistung aller öffentlichen Anbieter zurückzugeben, deren Identitätswert mit dem Buchstaben "Y" beginnt: -Filter "Y*". Verwenden Sie folgende Syntax, um eine Auflistung aller öffentlichen Anbieter zurückzugeben, deren Identitätswert die Zeichenfolge "Windows" enthält: -Filter "*Windows*".

LocalStore

Optional

Switch-Parameter

Ruft die Daten zum öffentlichen Anbieter aus dem lokalen Replikat des zentraler Verwaltungsspeichers ab, statt die Daten aus dem zentraler Verwaltungsspeicher selbst abzurufen.

Eingabetypen

Keine. Get-CsPublicProvider akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Gibt Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider" zurück.

Beispiel

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

Get-CsPublicProvider

Der Befehl in Beispiel 1 gibt eine Auflistung aller öffentlichen Anbieter zurück, die für die Verwendung in der Organisation konfiguriert wurden. Beim Aufrufen von Get-CsPublicProvider ohne zusätzliche Parameter wird immer eine vollständige Auflistung der öffentlichen Anbieter zurückgegeben.

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

Get-CsPublicProvider -Identity "MSN"

In Beispiel 2 werden alle öffentlichen Anbieter zurückgegeben, die den Identitätswert "MSN" aufweisen. Da die Identitätswerte von öffentlichen Anbietern (und von Hostinganbietern) eindeutig sein müssen, gibt dieser Befehl immer nur ein Element zurück.

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

Get-CsPublicProvider -Filter W*

Mit dem vorstehenden Befehl werden alle öffentlichen Anbieter zurückgegeben, deren Identitätswert mit dem Buchstaben "W" beginnt. Dazu werden der Parameter "Filter" und der Filterwert "W*" verwendet.

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

Get-CsPublicProvider | Where-Object {$_.Enabled -eq $False}

Der Befehl in Beispiel 4 gibt eine Auflistung aller derzeit deaktivierten öffentlichen Anbieter zurück. 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 nur die Anbieter auswählt, bei denen die Eigenschaft "Enabled" den Wert "False" aufweist.

-------------------------- Beispiel 5 ------------------------

Get-CsPublicProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable"}

Mit dem vorstehenden Befehl werden alle öffentlichen Anbieter zurückgegeben, bei denen die Eigenschaft "VerificationLevel" entweder auf "AlwaysUnverifiable" oder "UseSourceVerification" festgelegt ist. (Überprüfungsstufen können immer auf "AlwaysUnverifiable", "UseSourceVerification" oder "AlwaysVerifiable" festgelegt werden.) 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" nicht den Wert "AlwaysVerifiable" aufweist. Auswirkung: Es werden nur Anbieter herausgefiltert, bei denen die Eigenschaft "VerificationLevel" entweder auf "AlwaysUnverifiable" oder "UseSourceVerification" festgelegt ist.