Disable-CsHostingProvider
Letztes Änderungsdatum des Themas: 2012-03-23
Aktiviert einen Hostinganbieter, der gegenwärtig in Ihrer Organisation verwendet wird. 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
Disable-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Disable-CsHostingProvider [-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. 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 Lync Server 2010-Benutzer lokal (d. h. in der lokalen Implementierung von Lync Server) 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.) Sie können einen Hostinganbieter bei seiner Erstellung oder zu einem späteren Zeitpunkt mit dem Cmdlet Enable-CsHostingProvider aktivieren. Mit dem Cmdlet Disable-CsHostingProvider können Sie die Beziehung jederzeit deaktivieren. Beim Deaktivieren eines Hostinganbieters bleibt dieser Anbieter ein gültiger Verbundpartner, doch wird die Kommunikation zwischen Ihrer Organisation und dem Anbieter so lange unterbunden, bis der Anbieter reaktiviert wird.
Beachten Sie, dass ein Partnerverbund mit einem Hostinganbieter nicht möglich ist, wenn die Konfiguration der Edgeserver nicht das DNS-Serverrouting (Domain Name System), sondern das Standardrouting vorsieht.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Disable-CsHostingProvider 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-CsHostingProvider"}
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Optional |
Zeichenfolge |
Eindeutige ID des Hostinganbieters, der deaktiviert werden soll. 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.). |
Instance |
Optional |
DisplayHostingProvider-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.DisplayHostingProvider-Objekt. Disable-CsHostingProvider akzeptiert weitergeleitete Instanzen des Hostinganbieterobjekts.
Rückgabetypen
Keine. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider" deaktiviert.
Beispiel
-------------------------- Beispiel 1 --------------------------
Disable-CsHostingProvider -Identity "Fabrikam.com"
Der Befehl in Beispiel 1 deaktiviert den Hostinganbieter "Fabrikam.com". Beachten Sie, dass dieser Befehl eine Fehlermeldung zurückgibt, wenn "Fabrikam.com" bereits deaktiviert wurde.
-------------------------- Beispiel 2 --------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $True} | Disable-CsHostingProvider
Mit dem vorstehenden Befehl werden alle Hostinganbieter deaktiviert, die derzeit aktiviert 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 Anbieter herausfiltert, bei denen die Eigenschaft "Enabled" den Wert "True" aufweist. Diese gefilterte Auflistung wird anschließend an das Cmdlet Disable-CsHostingProvider weitergeleitet, um sämtliche Anbieter in der Auflistung zu deaktivieren.
-------------------------- Beispiel 3 --------------------------
Get-CsHostingProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable" -and $_.Enabled -eq $True} | Disable-CsHostingProvider
In Beispiel 3 werden alle aktivierten Hostinganbieter deaktiviert, deren Überprüfungsstufe einen anderen Wert als "AlwaysVerifiable" aufweist. 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 dann an das Where-Object weitergeleitet, das nur die Anbieter auswählt, die zwei Kriterien erfüllen: 1) die Eigenschaft "VerificationLevel " weist nicht den Wert "AlwaysVerifiable" auf und 2) die Eigenschaft "Enabled" weist den Wert "True" auf. Diese gefilterte Auflistung wird anschließend an das Cmdlet Disable-CsHostingProvider weitergeleitet, um sämtliche Anbieter in der Auflistung zu deaktivieren.
Siehe auch
Weitere Ressourcen
Enable-CsHostingProvider
Get-CsHostingProvider
New-CsHostingProvider
Remove-CsHostingProvider
Set-CsHostingProvider