Enable-CsHostingProvider
上一次修改主题： 2012-03-23
使组织中可使用某个托管提供商。宿主提供商是一个第三方组织，可为您希望与其联盟的域提供即时消息、状态和相关服务。宿主提供商（如 Microsoft Lync Online 2010）与公共提供商（如 Yahoo!、MSN 和 AOL）不同，因为其服务不提供给普通公众。
语法
Enable-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Enable-CsHostingProvider [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
详细说明
联盟是一种方式，两个组织可通过此种方式建立信任关系，从而便利组织间的通信。建立联盟之后，两个组织中的用户可以相互发送即时消息，订阅状态通知以及使用 Microsoft Lync 2010 等 SIP 应用程序进行彼此通信。Microsoft Lync Server 2010 允许建立三种类型的联盟：1) 您的组织与其他组织之间的直接联盟；2) 您的组织与公共提供商之间的联盟；以及 3) 您的组织与第三方托管提供商之间的联盟。
宿主提供商是为其他组织提供 SIP 通信服务的组织；例如，Fabrikam, Inc. 可以托管 Contoso、Northwind Traders、Wingtip Toys 等的用户。与托管提供商建立联盟关系时，实际上就与该提供商所托管的任何组织都建立了联盟。例如，如果您与 Fabrikam 联盟，您的用户将能够与 Contoso、Northwind Traders 和 Wingtip Toys 的用户交换即时消息和状态信息。
托管提供商还可用于拆分域的情况下。在拆分域方案中，一些 Lync Server 2010 用户具有内部托管（即由 Lync Server 的本地实现托管）的帐户。其他用户的帐户由第三方宿主提供商在外部进行维护。通过与宿主提供商联盟，内部用户和外部用户可以相互通信。
为与第三方宿主提供商联盟，需要创建并启用一个新的宿主提供商。（此外，第三方提供商也需要与您建立联盟关系。）可在创建托管提供商时启用该提供商；或者，可在创建后使用 Enable-CsHostingProvider cmdlet 启用该提供商
请注意，如果边缘服务器配置为使用默认路由而不是域名系统 (DNS) 服务器路由，则您不能与宿主提供商联盟。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Enable-CsHostingProvider cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Enable-CsHostingProvider"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
字符串 |
要启用的托管提供商的唯一标识符。Identity 可能是宿主提供商的完全限定域名 (FQDN)（如 fabrikam.com），也可能是提供服务的公司的名称 (Fabrikam, Inc.)。 |
Instance |
可选 |
显示宿主提供商对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 对象。Enable-CsHostingProvider 接受通过管道传递的宿主提供商对象的实例。
返回类型
无。此 cmdlet 启用 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 对象的实例。
示例
-------------------------- 示例 1 ------------------------
Enable-CsHostingProvider -Identity Fabrikam.com
示例 1 中使 Identity 为 Fabrikam.com 的托管提供商可供使用。注意，如果已使 Fabrikam.com 可供使用，则此命令将返回错误。
-------------------------- 示例 2 ------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $False} | Enable-CsHostingProvider
示例 2 显示如何能够启用当前禁用的所有托管提供商。为此，该命令首先调用 Get-CsHostingProvider（无任何其他参数）返回当前配置为在组织中使用的所有托管提供商的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会选择 Enabled 属性等于 False 的任何提供商；根据定义，这是当前禁用的任何提供商。然后，将筛选出的此集合通过管道传递给 Enable-CsHostingProvider，后者启用集合中的每一项提供商。
-------------------------- 示例 3 ------------------------
Get-CsHostingProvider | Where-Object {$_.EnabledSharedAddressSpace -eq $True -and $_.Enabled -eq $False} | Enable-CsHostingProvider
在示例 3 中，“拆分域”设置中使用的所有托管提供商都已可供使用。（分割域是指您的部分 Lync Server 帐户在内部维护，而其他帐户由宿主提供商维护。）为完成此任务，该命令首先使用 Get-CsHostingProvider 以返回当前配置的所有托管提供商的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会仅选择满足以下两个条件的提供商：1) EnabledSharedAddressSpace 属性等于 True；和 2) Enabled 属性等于 False。然后，将筛选出的集合通过管道传递给 Enable-CsHostingProvider，后者启用集合中的每个提供商。