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