• Artikel

New-CsHostingProvider

 

Letztes Änderungsdatum des Themas: 2012-03-26

Erstellt einen neuen Hostinganbieter für die Verwendung in Ihrer Organisation. Ein Hostinganbieter ist eine private 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

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

New-CsHostingProvider -Identity <XdsGlobalRelativeIdentity> -Enabled <$true | $false> -EnabledSharedAddressSpace <$true | $false> -HostsOCSUsers <$true | $false> -ProxyFqdn <String> [-AutodiscoverUrl <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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.) Mithilfe des Cmdlets New-CsHostingProvider können Sie drei Arten von Beziehungen mit Hostinganbietern einrichten:

Direkter Partnerverbund mit dem Hostinganbieter. Zum Erstellen dieser Art von Beziehung müssen die drei folgenden erforderlichen Parameter aufgenommen werden: "Identity", "ProxyFQDN" und "Enabled".

Getrennte Domänen, wobei Lync Server-Dienste gehostet werden. Zum Erstellen dieser Art von Beziehung müssen die drei erforderlichen Parameter aufgenommen werden. Darüber hinaus müssen die Eigenschaften "EnabledSharedAddressSpace" und "HostsOCSUsers" auf "True" festgelegt werden.

Getrennte Domänen, wobei andere Dienste, nicht Lync Server-Dienste, gehostet werden (z. B. Microsoft Exchange). Zum Erstellen dieser Art von Beziehung müssen die drei erforderlichen Parameter aufgenommen werden. Darüber hinaus muss "EnabledSharedAddressSpace" auf "True" und "HostsOCSUsers" auf "False" gesetzt werden.

Beim Erstellen eines neuen Hostinganbieters müssen die Identität und der vollqualifizierte Domänenname des Proxys (FQDN) für diesen Anbieter eindeutig sein: Sie können nicht über zwei Hostinganbieter (oder einen Hostinganbieter und einen öffentlichen Anbieter) mit derselben Identität bzw. demselben Proxy-FQDN verfügen.

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 New-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 "New-CsHostingProvider"}

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Zeichenfolge

Eindeutige ID für den zu erstellenden Hostinganbieter. 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.).

Hostinganbieter müssen über eindeutige Identitäten verfügen. Beim Versuch, einen neuen Hostinganbieter mit der Identität eines bereits vorhandenen Anbieters zu erstellen, tritt bei der Ausführung des Befehls ein Fehler auf.

Enabled

Erforderlich

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".

ProxyFqdn

Erforderlich

FQDN

Der FQDN für den vom Hostinganbieter verwendeten Proxyserver. Beachten Sie, dass dieser Wert nicht geändert werden kann. Wenn der Hostinganbieter seinen Proxyserver später ändert oder wenn Sie bei der ersten Angabe des Proxy-FQDN einen Fehler machen, müssen Sie den Eintrag für diesen Anbieter löschen und anschließend neu erstellen.

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.

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-Konten verwendet wird. Der Wert "False" gibt an, dass der Anbieter andere Kontotypen (z. B. Microsoft Exchange-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 "AlwayVerifiable".

Force

Optional

Switch-Parameter

Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können.

InMemory

Optional

Switch-Parameter

Erstellt einen Objektverweis ohne einen Commit für das Objekt auszuführen und die Änderungen dadurch dauerhaft zu speichern. Wenn Sie die Ausgabe des mit diesem Parameter aufgerufenen Cmdlet einer Variablen zuweisen, können Sie die Eigenschaften des Objektverweises ändern und anschließend einen Commit für diese Änderungen ausführen, indem Sie das entsprechende Cmdlet vom Typ "Set-" aufrufen.

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

Keine. New-CsHostingProvider akzeptiert keine weitergeleitete Eingabe.

Rückgabetypen

Erstellt neue Instanzen des Objekts "Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider".

Beispiel

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

New-CsHostingProvider -Identity Fabrikam.com -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True

In Beispiel 1 wird ein neuer Hostinganbieter mit der Identität "Fabrikam.com" erstellt. Zusätzlich zur Identität werden in diesem Befehl die zwei anderen erforderlichen Parameter angegeben: "ProxyFQDN" (zur Angabe des von Fabrikam.com verwendeten Proxyservers) und "Enabled" (zur Angabe, ob der neue Hostinganbieter für die Verwendung aktiviert ist). Wenn nicht alle erforderlichen Parameter angegeben werden, werden Sie über New-CsHostingProvider zur Eingabe dieser Werte aufgefordert, um fortfahren zu können.

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

New-CsHostingProvider -Identity Fabrikam.com -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True -HostsOCSUsers $True -EnabledSharedAddressSpace $True

In Beispiel 2 wird gezeigt, wie ein neuer Hostinganbieter zur Verwendung in einem Szenario mit getrennten Domänen erstellt wird. (Bei getrennten Domänen werden einige Lync Server-Konten lokal, andere dagegen vom Hostinganbieter verwaltet.) Um diese Art von Hostinganbieter zu erstellen, müssen die drei erforderlichen Parameter ("Identity", "ProxyFqdn" und "Enabled") angegeben werden. Darüber hinaus müssen die Parameter "HostsOCSUsers" und "EnabledSharedAddressSpace" aufgenommen und auf "True" festgelegt werden. Um einen Anbieter für getrennte Domänen zum Hosten von anderen Diensten als Lync Server (z. B. Microsoft Exchange) zu erstellen, nehmen Sie diese zwei Parameter ebenfalls auf, legen "HostsOCSUsers" jedoch auf "False" fest.