Remove-CsPublicProvider
Letztes Änderungsdatum des Themas: 2012-03-26
Entfernt einen 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
Remove-CsPublicProvider -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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.) Wenn Sie sich zu einem späteren Zeitpunkt dazu entschließen, diese Beziehung zu beenden, können Sie den öffentlichen Anbieter mit dem Cmdlet Remove-CsPublicProvider löschen. Wenn Sie einen öffentlichen Anbieter löschen, wird der Anbieter von Ihrer Verbundpartnerliste gelöscht. Ab diesem Moment kann die Beziehung nur wieder hergestellt werden, indem der Anbieter neu erstellt wird. Wenn Sie eine Beziehung zeitweise aufheben möchten, verwenden Sie stattdessen das Cmdlet Disable-CsPublicProvider. Ein deaktivierter öffentlicher Anbieter wird nicht von der Liste der Verbundpartner gelöscht, sondern nur als deaktiviert markiert, und die Kommunikation zwischen Ihrer Organisation und diesem Anbieter wird ausgesetzt. Wenn Sie die Beziehung wiederherstellen möchten, können Sie den Anbieter mit dem Cmdlet Enable-CsPublicProvider wieder neu aktivieren.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Remove-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 "Remove-CsPublicProvider"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
Zeichenfolge |
Eindeutige ID für den zu entfernenden öffentlichen Anbieter. Als Identitätswert wird in der Regel der Name der Website verwendet, die die Dienste bereitstellt (z. B. Yahoo!, AOL, MSN). |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls 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. Remove-CsPublicProvider akzeptiert weitergeleitete Instanzen des Objekts für öffentliche Anbieter.
Rückgabetypen
Keine. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider" gelöscht.
Beispiel
-------------------------- Beispiel 1 ------------------------
Remove-CsPublicProvider -Identity "MSN"
Mit dem vorstehenden Befehl wird der öffentliche Anbieter mit dem Identitätswert "MSN" gelöscht. Nach Abschluss dieses Befehls wird "MSN" nicht mehr in der Liste der konfigurierten öffentlichen Anbieter angezeigt. Zu diesem Zeitpunkt kann ein neuer Partnerverbund mit MSN nur hergestellt werden, wenn der Anbieter neu erstellt wird.
-------------------------- Beispiel 2 ------------------------
Get-CsPublicProvider | Remove-CsPublicProvider
In Beispiel 2 werden alle für die Verwendung in der Organisation konfigurierten öffentlichen Anbieter gelöscht. Hierzu ruft der Befehl zunächst Get-CsPublicProvider auf, um eine Auflistung aller derzeit zur Verwendung konfigurierten öffentlichen Anbieter zurückzugeben. Diese Auflistung wird dann an das Cmdlet Remove-CsPublicProvider weitergeleitet, das jeden Anbieter in der Auflistung löscht.
-------------------------- Beispiel 3 ------------------------
Get-CsPublicProvider | Where-Object {$_.Enabled -eq $False} | Remove-CsPublicProvider
In Beispiel 3 werden alle öffentlichen Anbieter, die derzeit deaktiviert sind, aus dem Satz konfigurierter öffentlicher Anbieter entfernt. Hierzu ruft der Befehl zunächst Get-CsPublicProvider auf, um eine Auflistung aller derzeit für die Verwendung konfigurierten öffentlichen Anbieter zurückzugeben. 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. Diese gefilterte Auflistung wird dann an das Cmdlet Remove-CsPublicProvider weitergeleitet, das alle Elemente in der Auflistung löscht.
Siehe auch
Weitere Ressourcen
Disable-CsPublicProvider
Enable-CsPublicProvider
Get-CsPublicProvider
New-CsPublicProvider
Set-CsPublicProvider