Remove-CsHostingProvider
上一次修改主题： 2012-03-25
删除组织中当前使用的一个或多个托管服务提供商。托管服务提供商是一个第三方组织，可为您希望与其联盟的域提供即时消息、状态和相关服务。托管服务提供商（如 Microsoft Lync Online 2010）与公共提供商（如 Yahoo!、MSN 和 AOL）的不同在于其服务不提供给普通公众。
语法
Remove-CsHostingProvider -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
联盟是两个组织间建立信任关系以促进沟通的一种途径。建立联盟之后，两个组织中的用户可以相互发送即时消息，订阅状态通知以及使用 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 的本地实现中托管）。其他用户的帐户由第三方宿主提供商在外部进行维护。通过与宿主提供商联盟，内部用户和外部用户可以相互通信。
为与第三方宿主提供商联盟，需要创建并启用一个新的宿主提供商。（此外，第三方提供商还需要与您建立联盟关系。）如果您以后决定终止此关系，可以使用 Remove-CsHostingProvider cmdlet 来删除宿主提供商。删除托管服务提供商时，将从联盟伙伴列表中删除该提供商；此时，重新建立关系的唯一方法就是重新创建该提供商。如果要暂时终止关系，请改用 Disable-CsHostingProvider cmdlet。禁用某个宿主提供商时，不会从联盟伙伴列表中删除该提供商，而只是会将该提供商标记为禁用，并且禁止组织与该提供商之间的通信。要重新建立关系，可以使用 Enable-CsHostingProvider 重新启用该提供商。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsHostingProvider cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsHostingProvider"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
字符串 |
要删除的托管服务提供商的唯一标识符。Identity 是一个字符串值；Identity 可以是托管服务提供商的完全限定域名 (FQDN)（例如，fabrikam.com），也可以是提供服务的公司的名称 (Fabrikam, Inc.)。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 对象。Remove-CsHostingProvider 接受通过管道传递的托管服务提供商对象的实例。
返回类型
无。此 cmdlet 会删除 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsHostingProvider -Identity "Fabrikam.com"
示例 1 中显示的命令删除 Identity 为 Fabrikam.com 的托管服务提供商。删除该托管服务提供商后，与 Fabrikam.com（以及和 Fabrikam.com 关联的所有域）的联盟将终止。
-------------------------- 示例 2 --------------------------
Get-CsHostingProvider | Remove-CsHostingProvider
示例 2 删除配置为在组织中使用的所有托管服务提供商。为此，该命令首先使用 Get-CsHostingProvider 返回当前使用的所有宿主提供商的集合。然后，将该集合通过管道传递到 Remove-CsHostingProvider，后者会删除集合中的每一项。完成该命令后，将不再存在任何配置为使用的宿主提供商。
-------------------------- 示例 3 --------------------------
Get-CsHostingProvider -Filter "*Fabrikam*" | Remove-CsHostingProvider
上述命令删除字符串值“Fabrikam”显示在提供商标识中的某位置的所有托管服务提供商。为了实现此任务，该命令首先调用带有 Filter 的 Get-CsHostingProvider；筛选器值“*Fabrikam*”将返回的数据限制为 Identity 中的某位置包含“Fabrikam”的所有宿主提供商。例如，该命令将返回 Fabrikam.com、Fabrikam.net 和 FabrikamUsers.com 等提供商。然后，将筛选出的集合通过管道传递到 Remove-CsHostingProvider，后者将删除集合中的每一项。
-------------------------- 示例 4 --------------------------
Get-CsHostingProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable"} | Remove-CsHostingProvider
在示例 4 中，将删除验证级别设置为非 AlwaysVerifiable 的所有托管服务提供商。这是通过以下操作实现的：首先调用不带任何其他参数的 Get-CsHostingProvider；该命令将返回配置为在组织中使用的所有宿主提供商的集合。然后，将生成的集合通过管道传递到 Where-Object cmdlet，后者会仅选取 VerificationLevel 属性不等于 AlwaysVerifiable 的提供商。然后，将筛选出的集合通过管道传递给 Remove-CsHostingProvider，后者将删除该集合中的每个提供商。
-------------------------- 示例 5 --------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $False} | Remove-CsHostingProvider
上述命令删除当前已禁用的所有托管服务提供商。为此，该命令首先使用 Get-CsHostingProvider 返回配置为在组织中使用的所有宿主提供商的集合。该集合将通过管道传递到 Where-Object，后者会仅选取已禁用的提供商；也就是说，仅选取 Enabled 属性等于 False 的提供商。然后，将筛选出的集合通过管道传递到 Remove-CsHostingProvider，后者将删除已禁用的每个托管服务提供商。