New-CsHostingProvider
上一次修改主题： 2012-03-26
创建供组织中使用的新宿主提供商。宿主提供商是一个私人第三方组织，可为您希望与其联盟的域提供即时消息、状态和相关服务。宿主提供商（如 Microsoft Lync Online 2010）与公共提供商（如 Yahoo!、MSN 和 AOL）不同，因为其服务不提供给普通公众。
语法
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>]]
详细说明
联盟是两个组织间建立信任关系以促进沟通的一种途径。建立联盟之后，两个组织中的用户可以相互发送即时消息，订阅状态通知以及使用 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 的本地实现托管）的帐户。其他用户的帐户由第三方宿主提供商在外部进行维护。通过与宿主提供商联盟，内部用户和外部用户可以相互通信。
为与第三方宿主提供商联盟，需要创建并启用一个新的宿主提供商。（此外，第三方提供商还需要与您建立联盟关系。）New-CsHostingProvider cmdlet 可用于设置三种类型的托管提供商关系：
与宿主提供商之间的直接联盟。要创建此类型的关系，必须包括三个必需参数：Identity、ProxyFqdn 和 Enabled。
拆分域，托管 Lync Server 服务。要创建此类型的关系，必须包括三个必需参数。此外，还必须将 EnabledSharedAddressSpace 和 HostsOCSUsers 属性都设置为 True。
分割域，托管非 Lync Server 服务（例如 Microsoft Exchange）。要创建此类型的关系，必须包括三个必需参数。此外，还必须将 EnabledSharedAddressSpace 设置为 True，将 HostsOCSUsers 设置为 False。
创建新的宿主提供商时，该提供商的标识和代理完全限定域名 (FQDN) 都必须是唯一的：两个宿主提供商（即使一个是宿主提供商，另一个是公共提供商）不能共享同一个标识和/或代理 FQDN。
请注意，如果边缘服务器配置为使用默认路由而不是域名系统 (DNS) 服务器路由，则您不能与宿主提供商联盟。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsHostingProvider cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsHostingProvider"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
字符串 |
要创建的宿主提供商的唯一标识符。Identity 就是一个字符串值；Identity 可能是宿主提供商的 FQDN（如 fabrikam.com），也可能是提供服务的公司的名称 (Fabrikam, Inc.)。 宿主提供商标识必须是唯一的。如果您尝试创建的新宿主提供商与某个现有提供商的标识相同，则命令将会失败。 |
Enabled |
必需 |
布尔值 |
指示您的域与宿主提供商之间的网络连接是否已启用。除非该值设置为 True，否则无法在这两个组织之间交换消息。默认值为 False。 |
ProxyFqdn |
必需 |
FQNDN |
宿主提供商使用的代理服务器的 FQDN。请注意无法修改该值。如果宿主提供商稍后更改其代理服务器或者您在首次指定代理 FQDN 时出错，则您必须删除该条目，然后为提供商重新创建相应条目。 |
AutoDiscoverUrl |
可选 |
字符串 |
托管 Lync Server 帐户的宿主提供商使用的自动发现服务的 URL。自动发现服务使 Microsoft Lync Mobile 等客户端应用程序能够确定如何访问资源，如用户的主池。 |
EnabledSharedAddressSpace |
可选 |
布尔值 |
如果设置为 True，则指示正在分割域方案中使用宿主提供商。默认值为 False。 |
HostsOCSUsers |
可选 |
布尔值 |
如果设置为 True，则指示托管服务提供商用于托管 Lync Server 帐户。如果设置为 False，则指示提供商托管其他帐户类型，例如 Microsoft Exchange 帐户。默认值为 False。 |
IsLocal |
可选 |
布尔值 |
如果设置为 True，则指示托管服务提供商使用的代理服务器包含于您的 Lync Server 拓扑中。默认值为 False。 |
VerificationLevel |
可选 |
字符串 |
指示与宿主提供商之间往来发送的消息的允许验证级别。VerificationLevel 必须设置为下列值之一： AlwaysVerifiable。指示所有发送自宿主提供商的消息都将视为是可验证的。这意味着不会拒绝来自宿主提供商的任何消息。 AlwaysUnverifiable。指示所有发送自宿主提供商的消息都将视为是不可验证的。因此，仅当托管服务提供商的用户也位于您的联系人列表中时，才会传递其消息。 UseSourceVerification。依赖于发送自宿主提供商的消息中包含的验证级别。如果未指定此级别，则消息将会由于被视为不可验证而遭拒绝。 默认值为 AlwayVerifiable。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。New-CsHostingProvider 不接受通过管道传递的输入。
返回类型
创建 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayHostingProvider 对象的新实例。
示例
-------------------------- 示例 1 --------------------------
New-CsHostingProvider -Identity Fabrikam.com -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True
在示例 1 中，将创建一个 Identity 为 Fabrikam.com 的新宿主提供商。除了指定 Identity 之外，该命令还包括其他两个必需参数：ProxyFqdn（用于指定 Fabrikam.com 使用的代理服务器）；以及 Enabled，用于指示是否启用新的托管提供商。如果您省略任一必需参数，New-CsHostingProvider 将提示您在继续之前输入其值。
-------------------------- 示例 2 --------------------------
New-CsHostingProvider -Identity Fabrikam.com -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True -HostsOCSUsers $True -EnabledSharedAddressSpace $True
示例 2 演示如何创建新的宿主提供商供在分割域方案中使用。（分割域是指您的部分 Lync Server 帐户在内部维护，而其他帐户由宿主提供商维护。）要创建此类型的托管提供商，必须包括三个必需参数（Identity、ProxyFqdn 和 Enabled）。此外，还必须包括 HostsOCSUsers 和 EnabledSharedAddressSpace 参数并将其均设置为 True。要创建托管非 Lync Server 服务（例如 Microsoft Exchange）的分割域提供商，也应包括这两个参数，但应将 HostsOCSUsers 设置为 False。