Freigeben über

  • Artikel

Set-CsHostingProvider

 

Letztes Änderungsdatum des Themas: 2012-03-26

Ändert einen gegenwärtig in Ihrer Organisation verwendeten Hostinganbieter. 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

Set-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-EnabledSharedAddressSpace <$true | $false>] [-Force <SwitchParameter>] [-HostsOCSUsers <$true | $false>] [-IsLocal <$true | $false>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]

Set-CsHostingProvider [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-EnabledSharedAddressSpace <$true | $false>] [-Force <SwitchParameter>] [-HostsOCSUsers <$true | $false>] [-Instance <PSObject>] [-IsLocal <$true | $false>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-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 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.) Nach dem Erstellen eines Hostinganbieters können Sie die Eigenschaften dieses Anbieters mithilfe des Cmdlets Set-CsHostingProvider ändern. Mit diesem Cmdlet kann z. B. der vollqualifizierte Domänenname (FQDN) des Proxyservers oder die Überprüfungsstufe für diesen Anbieter geändert werden.

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 dürfen Mitglieder der folgenden Gruppen das Cmdlet Set-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 "Set-CsHostingProvider"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Optional

Zeichenfolge

Eindeutige ID für den zu ändernden Hostinganbieter. Als Identitätswert kann der 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.

AutoDiscoverUrl

Optional

Zeichenfolge

URL des AutoErmittlungsdiensts, der von einem Hostinganbieter verwendet wird, der als Host von Lync Server-Konten dient. Der AutoErmittlungsdienst ermöglicht Clientanwendungen wie Microsoft Lync Mobile das Bestimmen, wie auf Ressourcen wie den Home-Pool eines Benutzers zugegriffen werden soll.

Enabled

Optional

Boolescher Wert

Gibt an, ob die Netzwerkverbindung zwischen Ihrer Domäne und dem Hostinganbieter aktiviert ist. Der Nachrichtenaustausch zwischen zwei Organisationen ist erst möglich, wenn dieser Wert auf "True" festgelegt ist. Der Standardwert lautet "False".

EnabledSharedAddressSpace

Optional

Boolescher Wert

Der Wert "True" gibt an, dass der Hostinganbieter in einem Szenario mit getrennten Domänen verwendet wird. Der Standardwert lautet "False".

HostsOCSUsers

Optional

Boolescher Wert

Der Wert "True" gibt an, dass der Hostinganbieter zum Hosten von Lync Server 2010-Konten verwendet wird. Der Wert "False" gibt an, dass der Anbieter andere Kontotypen (z. B. Microsoft Exchange Server-Konten) hostet. Der Standardwert lautet "False".

IsLocal

Optional

Boolescher Wert

Der Wert "True" gibt an, dass sich der vom Hostinganbieter verwendete Proxyserver in Ihrer Lync Server-Topologie befindet. Der Standardwert lautet "False".

VerificationLevel

Optional

Zeichenfolge

Gibt die zulässige Überprüfungsstufe für Nachrichten an, die vom Hostinganbieter gesendet oder empfangen werden. Die Eigenschaft "VerificationLevel" muss auf einen der folgenden Werte festgelegt werden:

"AlwaysVerifiable". Gibt an, dass alle vom Hostinganbieter gesendeten Nachrichten als überprüfbar gelten. Das bedeutet, dass keine Nachrichten vom Hostinganbieter abgelehnt werden.

"AlwaysUnverifiable". Gibt an, dass alle vom Hostinganbieter gesendeten Nachrichten als nicht überprüfbar gelten. Folglich werden Nachrichten nur dann gesendet, wenn der Benutzer des Hostinganbieters in Ihrer Kontaktliste enthalten ist.

"UseSourceVerification". Dieser Wert hängt von der Überprüfungsstufe in Nachrichten ab, die vom Hostinganbieter gesendet werden. Wenn diese Stufe nicht angegeben ist, wird die Nachricht als nicht überprüfbar eingestuft und abgelehnt.

Der Standardwert ist "AlwaysVerifiable".

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. Set-CsHostingProvider akzeptiert weitergeleitete Instanzen des Hostinganbieterobjekts.

Rückgabetypen

Set-CsHostingProvider gibt keine Werte oder Objekte zurück. Stattdessen werden mit dem Cmdlet Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider" konfiguriert.

Beispiel

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

Set-CsHostingProvider -Identity "Fabrikam.com" -VerificationLevel "AlwaysUnverifiable"

Über den vorstehenden Befehl wird der Hostinganbieter mit der Identität "Identity Fabrikam.com" geändert. In diesem Beispiel wird die Eigenschaft "VerificationLevel" auf "AlwaysUnverifiable" festgelegt.

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

Get-CsHostingProvider | Set-CsHostingProvider -VerificationLevel "AlwaysUnverifiable"

Beispiel 2 ist eine Variante des in Beispiel 1 gezeigten Befehls. In diesem Fall wird die Überprüfungsstufe jedoch für alle Hostinganbieter auf "AlwaysUnverifiable" festgelegt. Hierzu wird zunächst Get-CsHostingProvider verwendet, um eine Auflistung aller für die Verwendung in der Organisation konfigurierten Hostinganbieter zurückzugeben. Diese Auflistung wird dann an das Cmdlet Set-CsHostingProvider weitergeleitet, das die Eigenschaft "VerificationLevel" für jeden Anbieter in der Auflistung ändert.

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

Get-CsHostingProvider | Where-Object {$_.EnabledSharedAddressSpace -eq $True -and $_.HostsOCSUsers -eq $True} | Set-CsHostingProvider -EnabledSharedAddressSpace $False -HostsOCSUsers $False

In Beispiel 3 werden alle gegenwärtig für die Verwendung in einem Szenario mit getrennten Domänen konfigurierten Hostinganbieter so geändert, dass sie nicht länger für einen Partnerverbund mit getrennten Domänen verwendet werden. In diesem Beispiel wird zunächst Get-CsHostingProvider aufgerufen, um eine Auflistung aller verfügbaren Hostinganbieter zurückzugeben. Diese Auflistung wird dann an das Cmdlet Where-Object weitergeleitet, das nur die Anbieter auswählt, die zwei Kriterien erfüllen: 1) die Eigenschaft "HostsOCSUsers" lautet "True" und 2) die Eigenschaft "EnabledSharedAddressSpace" lautet "True". Diese gefilterte Auflistung wird anschließend an das Cmdlet Set-CsHostingProvider weitergeleitet, das die Eigenschaften "EnabledSharedAddressSpace" und "HostsOCSUsers" auf "False" festlegt. Anschließend sind die Hostinganbieter in der Auflistung weiterhin für den Partnerverbund aktiviert, sie werden jedoch nicht länger in einem Szenario mit getrennten Domänen verwendet.