Disable-CsPublicProvider
Letztes Änderungsdatum des Themas: 2012-03-23
Deaktiviert 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
Disable-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Disable-CsPublicProvider [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 (Session Inititation Protocol) für die breite Öffentlichkeit bereitstellt. 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 einen öffentlichen Anbieter erstellen, können Sie diese Partnerverbundbeziehung entweder aktivieren oder deaktivieren. Wird ein öffentlicher Anbieter aktiviert, können Benutzer in der Organisation Sofortnachrichten und Anwesenheitsinformationen mit Personen austauschen, die über ein Konto bei dem öffentlichen Anbieter verfügen. Wird ein öffentlicher Anbieter deaktiviert, besteht so lange keine Möglichkeit mehr, mit Personen mit einem Konto bei dem öffentlichen Anbieter zu kommunizieren, bis der Anbieter wieder aktiviert wurde. Wenn Sie eine Beziehung mit einem Anbieter zeitweise unterbrechen müssen, verwenden Sie das Cmdlet Disable-CsPublicProvider. Ziehen Sie es vor, den Anbieter vollständig zu löschen, verwenden Sie das Cmdlet Remove-CsPublicProvider.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Disable-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 "Disable-CsPublicProvider"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Optional |
Zeichenfolge |
Eindeutige ID für den zu deaktivierenden öffentlichen Anbieter. Als Identitätswert wird in der Regel der Name der Website verwendet, die die Dienste bereitstellt (z. B. Yahoo!, AOL, MSN). |
Instance |
Optional |
DisplayPublicProvider-Objekt |
Ermöglicht Ihnen, einen Verweis auf ein Objekt an das Cmdlet zu übergeben, statt individuelle Parameterwerte festzulegen. |
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. Disable-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" deaktiviert.
Beispiel
-------------------------- Beispiel 1 ------------------------
Disable-CsPublicProvider -Identity "MSN"
Mit dem vorstehenden Befehl wird der öffentliche Anbieter mit dem Identitätswert "MSN" deaktiviert. Wenn "MSN" bereits deaktiviert ist, wird beim Ausführen dieses Befehls ein Fehler zurückgegeben.
-------------------------- Beispiel 2 ------------------------
Get-CsPublicProvider | Where-Object {$_.Enabled -eq $True} | Disable-CsPublicProvider
In Beispiel 2 werden alle derzeit aktivierten öffentlichen Anbieter deaktiviert. Dazu ruft der Befehl zunächst Get-CsPublicProvider auf, um eine Auflistung aller öffentlichen Anbieter zurückzugeben, die derzeit in der Organisation verwendet werden. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet, das nur die Anbieter herausfiltert, bei denen die Eigenschaft "Enabled" den Wert "True" aufweist. Diese Auflistung wird an das Cmdlet Disable-CsPublicProvider weitergeleitet, das jeden Anbieter in der Auflistung deaktiviert.
-------------------------- Beispiel 3 ------------------------
Get-CsPublicProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable" -and $_.Enabled -eq $True} | Disable-CsPublicProvider
Der Befehl in Beispiel 3 deaktiviert alle öffentlichen Anbieter, die derzeit aktiviert sind und bei denen die Überprüfungsstufe auf "AlwaysVerifiable" gesetzt ist. Dazu ruft der Befehl zunächst Get-CsPublicProvider auf, um eine Auflistung aller öffentlichen Anbieter zurückzugeben, die derzeit in der Organisation verwendet werden. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Anbieter auswählt, die zwei Kriterien erfüllen: 1) Die Eigenschaft "VerificationLevel " weist den Wert "AlwaysVerifiable" auf, und 2) die Eigenschaft "Enabled" weist den Wert "True" auf. (Der Operator "-and" weist Where-Object an, dass ein Objekt alle angegebenen Kriterien erfüllen muss, um ausgewählt zu werden.) Die gefilterte Auflistung wird dann an das Cmdlet Disable-CsPublicProvider weitergeleitet, das jeden Anbieter in der Auflistung deaktiviert.
Siehe auch
Weitere Ressourcen
Enable-CsPublicProvider
Get-CsPublicProvider
New-CsPublicProvider
Remove-CsPublicProvider
Set-CsPublicProvider