Disable-CsHostingProvider
上一次修改主题： 2012-03-23
禁用组织中当前使用的托管服务提供商。宿主提供商是一个第三方组织，可为您希望与其联盟的域提供即时消息、状态和相关服务。宿主提供商（如 Microsoft Lync Online 2010）与公共提供商（如 Yahoo!、MSN 和 AOL）不同，因为其服务不提供给普通公众。
语法
Disable-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Disable-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 事后启用该提供商。另外，可随时使用 Disable-CsHostingProvider cmdlet 禁用联盟关系。禁用托管服务提供商后，此提供商仍然是有效的联盟伙伴；但您的组织和此提供商之间的所有通信活动将暂停，直到重新启用该提供商。
请注意，如果边缘服务器配置为使用默认路由而不是域名系统 (DNS) 服务器路由，则您不能与宿主提供商联盟。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Disable-CsHostingProvider cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Disable-CsHostingProvider"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
字符串 |
要禁用的托管服务提供商的唯一标识符。Identity 可以是托管服务提供商的完全限定域名 (FQDN)（例如，fabrikam.com），也可以是提供服务的公司的名称 (Fabrikam, Inc.)。 |
Instance |
可选 |
显示宿主提供商对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 对象。Disable-CsHostingProvider 接受通过管道传递的托管服务提供商对象的实例。
返回类型
无。此 cmdlet 会禁用 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 对象的实例。
示例
-------------------------- 示例 1 ------------------------
Disable-CsHostingProvider -Identity "Fabrikam.com"
示例 1 中显示的命令将禁用托管服务提供商 Fabrikam.com。请注意，如果 Fabrikam.com 已禁用，则此命令将返回错误消息。
-------------------------- 示例 2 ------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $True} | Disable-CsHostingProvider
上述命令将禁用当前已启用的所有托管服务提供商。为此，该命令首先调用 Get-CsHostingProvider 返回配置为在组织中使用的所有托管服务提供商的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者将仅挑选出 Enabled 属性等于 True 的提供商。最后将此筛选出的集合通过管道传递到 Disable-CsHostingProvider，后者将禁用集合中的每个提供商。
-------------------------- 示例 3 ------------------------
Get-CsHostingProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable" -and $_.Enabled -eq $True} | Disable-CsHostingProvider
在示例 3 中，将禁用验证级别不等于 AlwaysVerifiable 的所有已启用的托管服务提供商。为实现此任务，该命令首先调用 Get-CsHostingProvider 返回配置为在组织中使用的所有托管服务提供商的集合。然后将此集合通过管道传递到 Where-Object cmdlet，该 cmdlet 只选择满足以下两个条件的提供商：1) VerificationLevel 属性不等于 AlwaysVerifiable；以及 2) Enabled 属性等于 True。最后将此筛选出的集合通过管道传递到 Disable-CsHostingProvider，后者将禁用集合中的每个提供商。