Set-CsPublicProvider
上一次修改主题： 2012-03-25
修改当前配置为在组织中使用的公共提供商。公共提供商是向普通公众提供即时消息 (IM)、状态和相关服务的组织。Microsoft Lync Server 2010 附带了三个已配置但尚未启用的公共提供商：Yahoo!、AOL 和 MSN。
语法
Set-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]
Set-CsPublicProvider [-Confirm [<SwitchParameter>]] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]
详细说明
联盟是两个组织间建立信任关系以促进沟通的一种途径。建立联盟之后，两个组织中的用户可以相互发送即时消息，订阅状态通知以及使用 Microsoft Lync 2010 等 SIP 应用程序进行彼此通信。Lync Server 2010 允许建立三种类型的联盟：1) 在您的组织与其他组织之间直接建立联盟；2) 在您的组织与公共提供商之间建立联盟；以及 3) 在您的组织与第三方宿主提供商之间建立联盟。
公共提供商是为普通公众提供 SIP 通信服务的组织。当您与某个公共提供商建立联盟关系后，实际上便与具有该提供商所托管的帐户的所有用户都建立了联盟关系。例如，如果您与 MSN 联盟，那么（取决于您如何配置系统）您的用户将能够与任何具有 MSN 即时消息帐户的人交换即时消息和状态信息。
为了与公共提供商联盟，您需要创建并启用一个新的公共提供商。（此外，公共提供商还需要与您建立联盟关系。）Lync Server 包括三个预配置的公共提供商：Yahoo!、AOL 和 MSN。配置其他公共提供商以后，可使用 New-CsPublicProvider cmdlet 创建与这些新提供商的联盟关系。在建立联盟关系后，可以使用 Set-CsPublicProvider 修改这些关系中的两个重要属性值（Enabled 和 VerificationLevel）。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsPublicProvider cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsPublicProvider"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
字符串 |
要修改的公共提供商的唯一标识符。Identity 通常是提供相关服务的网站名称（例如 Yahoo!、AOL、MSN 等）。 |
Instance |
可选 |
DisplayPublicProvider 对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
Enabled |
可选 |
开关参数 |
指示您的组织与公共提供商之间的联盟关系是否处于活动状态。如果设置为 True，那么您组织中的用户将能够与具有相应公共提供商托管帐户的用户交换即时消息和状态信息。如果设置为 False，那么您组织中的用户将不能与具有相应公共提供商托管帐户的用户交换即时消息和状态信息。 |
VerificationLevel |
可选 |
字符串 |
指示发自公共提供商的信息如何（或是否）经过验证以确保这些消息是从该提供商发送的。VerificationLevel 必须设置为下列值之一： AlwaysVerifiable。将接受所有据称发自此提供商的消息。如果在消息中未找到验证标头，则 Lync Server 2010 将添加该标头。此值为默认值。 AlwaysUnverifiable。将所有据称发自公共提供商的消息视为未经验证。只有在发送这些消息的人员位于接收人的联系人列表中时才会提交这些消息。例如，如果 Ken Myer 在您的联系人列表中，则您可以收到他发来的消息。如果 Pilar Ackerman 不在您的联系人列表中，则您将无法收到她发来的消息。 UseSourceVerification。使用公共提供商向消息添加的验证标头。如果缺少验证信息，则将拒绝消息。 |
Force |
可选 |
开关参数 |
禁止显示运行此 cmdlet 时可能出现的任何确认提示或非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider 对象。Set-CsPublicProvider 接受通过管道传递的公共提供商对象的实例。
返回类型
Set-CsPublicProvider 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsPublicProvider -Identity "MSN" -VerificationLevel "UseSourceVerification"
上述命令设置 Identity 为 MSN 的公共提供商的 VerificationLevel。这是通过包含 VerificationLevel 参数和参数值 UseSourceVerification 来实现的。
-------------------------- 示例 2 --------------------------
Get-CsPublicProvider | Set-CsPublicProvider -VerificationLevel "UseSourceVerification"
在示例 2 中，修改当前组织中使用的所有公共提供商的验证级别。为执行此操作，该命令首先调用不带任何参数的 Get-CsPublicProvider 以返回当前配置以供使用的所有公共提供商的集合。然后将该集合通过管道传递到 Set-CsPublicProvider，后者选取该集合中的每个提供商，并将 VerificationLevel 属性的值更改为 UseSourceVerification。
-------------------------- 示例 3
Get-CsPublicProvider | Where-Object {$_.VerificationLevel -eq "AlwaysVerifiable"} | Set-CsPublicProvider -VerificationLevel "UseSourceVerification"
示例 3 中显示的命令修改当前验证级别设置为 AlwaysVerifiable 的任何公共提供商的验证级别。为实现此任务，该命令首先调用 Get-CsPublicProvider，以返回配置为在组织中使用的所有公共提供商的集合。然后将该集合通过管道传递到 Where-Object cmdlet，后者将仅挑选出 VerificationLevel 属性等于 AlwaysVerifiable 的提供商。接下来，将筛选出的集合通过管道传递到 Set-CsPublicProvider，后者将集合中每个提供商的 VerificationLevel 更改为 UseSourceVerification。