Get-CsHostingProvider
上一次修改主题： 2012-03-23
返回有关配置为在组织中使用的托管服务提供商的信息。宿主提供商是一个第三方组织，可为您希望与其联盟的域提供即时消息、状态和相关服务。宿主提供商（如 Microsoft Lync Online 2010）与公共提供商（如 Yahoo!、MSN 和 AOL）不同，因为其服务不提供给普通公众。
语法
Get-CsHostingProvider [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsHostingProvider [-Filter <String>] [-LocalStore <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 用户具有内部托管（即由 Lync Server 的本地实现托管）的帐户。其他用户的帐户由第三方宿主提供商在外部进行维护。通过与宿主提供商联盟，内部用户和外部用户可以相互通信。
Get-CsHostingProvider cmdlet 提供了一种返回有关配置为在组织中使用的所有托管提供商的信息的方法。
请注意，如果边缘服务器配置为使用默认路由而不是域名系统 (DNS) 服务器路由，则您不能与宿主提供商联盟。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsHostingProvider cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsHostingProvider"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
字符串 |
要返回的托管服务提供商的唯一标识符。Identity 可以是托管服务提供商的完全限定域名 (FQDN)（例如，fabrikam.com），也可以是提供服务的公司的名称 (Fabrikam, Inc.)。 如果未指定此参数，Get-CsHostingProvider 将返回配置为在组织中使用的所有托管提供商的集合。 |
Filter |
可选 |
字符串 |
使您可以使用通配符值返回一个或多个托管服务提供商。例如，要返回标识以字符串值“.com”结尾的所有托管服务提供商，请使用以下语法：-Filter "*.com"。要返回标识以字符串“Fabri”开头的所有托管服务提供商，请使用以下语法：-Filter "Fabri*"。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而非中央管理存储本身检索托管服务提供商数据。 |
输入类型
无。Get-CsHostingProvider 不接受通过管道传递的输入。
返回类型
返回 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsHostingProvider
上述命令返回所有配置为在组织中使用的托管服务提供商的集合。调用不带其他任何参数的 Get-CsHostingProvider 总是返回托管服务提供商的完整集合。
-------------------------- 示例 2 --------------------------
Get-CsHostingProvider -Identity Fabrikam.com
示例 2 返回 Identity 为 Fabrikam.com 的托管提供商。由于托管提供商的标识必须唯一，因此此命令绝不会返回多项。
-------------------------- 示例 3 --------------------------
Get-CsHostingProvider -Filter *.org
示例 3 中显示的命令返回 Identity 以字符串值“.org”结尾的所有托管服务提供商（例如，fabrikam.org 和 contoso.org 等）的集合。
-------------------------- 示例 4 --------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $True}
在示例 4 中，返回所有当前可供使用的托管服务提供商。为执行此操作，首先调用 Get-CsHostingProvider 以返回当前配置为在组织中使用的所有托管服务提供商的集合。然后，将该集合通过管道传递到 Where-Object cmdle，后者将仅挑选出 Enabled 属性等于 True 的提供商。
-------------------------- 示例 5 --------------------------
Get-CsHostingProvider | Where-Object {$_.Enabled -eq $True -and $_.EnabledSharedAddressSpace -eq $True}
上述命令返回具有共享地址空间并托管 Lync Server 2010 用户的所有托管服务提供商；根据定义，这意味着该命令将返回作为“拆分域”安装一部分的所有托管服务提供商。（拆分域就是表示，一部分 Lync Server 帐户在内部维护，另一部分帐户由托管提供商维护。）为完成此任务，该命令首先使用 Get-CsHostingProvider 以返回当前配置的所有托管提供商的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会仅选择满足以下两个条件的提供商：1) Enabled 属性等于 True；和 2) EnabledSharedAddressSpace 属性等于 True。
-------------------------- 示例 6 --------------------------
Get-CsHostingProvider | Select-Object *
示例 6 中显示的命令显示配置为在组织中使用的所有托管服务提供商的所有属性值。默认情况下，运行 Get-CsHostingProvider 时，不显示 EnabledSharedAddressSpace 和 HostsOCSUsers 的属性值。要查看这些属性的值，请将 Get-CsHostingProvider 返回的信息通过管道传递到 Select-Object cmdlet；语法“Select-Object *”将指示 Get-CsHostingProvider 显示返回项的所有属性和属性值。