Freigeben über

  • Artikel

Remove-CsHostingProvider

 

Letztes Änderungsdatum des Themas: 2012-03-25

Entfernt einen oder mehrere Hostinganbieter, die derzeit in Ihrer Organisation verwendet werden. Ein Hostinganbieter ist eine Drittanbieterorganisation, die Instant Messaging-, Anwesenheits- und ähnliche Dienste für eine Domäne bereitstellt, mit der Sie einen Partnerverbund einrichten möchten. Hostinganbieter wie z. B. Microsoft Lync Online 2010 unterscheiden sich von öffentlichen Anbietern (wie Yahoo!, MSN und AOL) darin, dass sie ihre Dienste nicht für die breite Öffentlichkeit anbieten.

Syntax

Remove-CsHostingProvider -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 Lync 2010 miteinander kommunizieren. Microsoft 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 Hostinganbieter ist eine Organisation, die SIP-Kommunikationsdienste für andere Organisationen anbietet, z. B. könnte Fabrikam, Inc. als Host für Benutzer von Contoso, Northwind Traders und Wingtip Toys fungieren. Wenn Sie eine Partnerverbundbeziehung mit einem Hostinganbieter einrichten, stellen Sie im Prinzip einen Partnerverbund mit allen von diesem Anbieter gehosteten Organisationen her. Wenn Sie einen Partnerverbund mit Fabrikam einrichten, können Ihre Benutzer Sofortnachrichten und Anwesenheitsinformationen mit Benutzern von Contoso, Northwind Traders und Wingtip Toys austauschen.

Hostinganbieter werden auch in Szenarien mit getrennten Domänen eingesetzt. In diesem Fall werden die Konten einiger Ihrer Benutzer vor Ort (d. h. in der lokalen Implementierung von Lync Server 2010) gehostet, Für andere Benutzer werden die zugehörigen Konten extern durch den Drittanbieter-Hostinganbieter verwaltet. Das Einrichten eines Partnerverbunds mit dem Hostinganbieter ermöglicht die Kommunikation zwischen lokalen und externen Benutzern.

Um mit einem externen Hostinganbieter im Partnerverbund zu arbeiten, müssen Sie einen neuen Hostinganbieter erstellen und aktivieren. (Darüber hinaus muss der externe 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 Hostinganbieter mit dem Cmdlet Remove-CsHostingProvider löschen. Wenn Sie einen Hostinganbieter löschen, wird der Anbieter von Ihrer Liste der Verbundpartner 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-CsHostingProvider. Ein deaktivierter Hostinganbieter wird nicht aus der Liste der Verbundpartner gelöscht, sondern nur als deaktiviert gekennzeichnet, und die Kommunikation zwischen Ihrer Organisation und diesem Anbieter wird deaktiviert. Wenn Sie die Beziehung wieder herstellen möchten, können Sie den Anbieter mit dem Cmdlet Enable-CsHostingProvider erneut aktivieren.

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

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Zeichenfolge

Eindeutige ID für den Hostinganbieter, der entfernt werden soll. Der Wert für "Identity" ist ein Zeichenfolgenwert. Als Identitätswert kann der vollqualifizierte Domänenname (FQDN) des Hostinganbieters (z. B. "fabrikam.com") oder der Name des Unternehmens angegeben werden, das die Dienste bereitstellt (Fabrikam, Inc.).

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.DisplayHostingProvider-Objekt. Remove-CsHostingProvider akzeptiert weitergeleitete Instanzen des Hostinganbieterobjekts.

Rückgabetypen

Keine. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider" gelöscht.

Beispiel

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

Remove-CsHostingProvider -Identity "Fabrikam.com"

Der Befehl in Beispiel 1 löscht den Hostinganbieter mit dem Identitätswert "Fabrikam.com". Nachdem der Hostinganbieter gelöscht wurde, wird der Partnerverbund mit Fabrikam.com (und sämtlichen zugeordneten Domänen von Fabrikam.com) beendet.

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

Get-CsHostingProvider | Remove-CsHostingProvider

Mit dem Befehl in Beispiel 2 werden alle für die Verwendung in der Organisation konfigurierten Hostinganbieter gelöscht. Hierzu ruft der Befehl zunächst Get-CsHostingProvider auf, um eine Auflistung aller derzeit verwendeten Hostinganbieter zurückzugeben. Diese Auflistung wird dann an das Cmdlet Remove-CsHostingProvider weitergeleitet, das jedes Element in der Auflistung löscht. Nach Ausführung dieses Befehls sind keine Hostinganbieter mehr für die Verwendung konfiguriert.

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

Get-CsHostingProvider -Filter "*Fabrikam*" | Remove-CsHostingProvider

Mit dem vorstehenden Befehl werden sämtliche Hostinganbieter gelöscht, deren Identitätswert den Zeichenfolgenwert "Fabrikam" aufweist. Hierzu ruft der Befehl zunächst Get-CsHostingProvider mit dem Parameter "Filter" auf. Der Filterwert "*Fabrikam*" beschränkt die zurückgegebenen Daten auf Hostinganbieter, deren Identitätswert "Fabrikam" aufweist. Dieser Befehl würde beispielsweise Anbieter wie "Fabrikam.com", "Fabrikam.net" und "FabrikamUsers.com" zurückgeben. Die gefilterte Auflistung wird dann an das Cmdlet Remove-CsHostingProvider weitergeleitet, das jedes Element in der Auflistung löscht.

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

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

In Beispiel 4 werden alle Hostinganbieter gelöscht, deren Überprüfungsstufe einen anderen Wert als "AlwaysVerifiable" aufweist. Hierzu wird zunächst Get-CsHostingProvider ohne zusätzliche Parameter aufgerufen, um eine Auflistung aller für die Verwendung in der Organisation konfigurierten Hostinganbieter zurückzugeben. Die Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das die Anbieter herausfiltert, bei denen die Eigenschaft "VerificationLevel" nicht den Wert "AlwaysVerifiable" aufweist. Die gefilterte Auflistung wird anschließend an das Cmdlet Remove-CsHostingProvider weitergeleitet, um alle Anbieter in dieser Auflistung zu entfernen.

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

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

Mit dem vorstehenden Befehl werden alle Hostinganbieter entfernt, die derzeit deaktiviert sind. Hierzu ruft der Befehl zunächst Get-CsHostingProvider auf, um eine Auflistung aller derzeit für die Verwendung in der Organisation konfigurierten Hostinganbieter zurückzugeben. Diese Auflistung wird an das Cmdlet Where-Object weitergeleitet, das die deaktivierten Anbieter herausfiltert, d. h. solche Anbieter, bei denen die Eigenschaft "Enabled" den Wert "False" aufweist. Die gefilterte Auflistung wird dann an das Cmdlet Remove-CsHostingProvider weitergeleitet, das alle deaktivierten Hostinganbieter löscht.