New-CsPublicProvider
上一次修改主题： 2012-03-26
与新的公共提供商建立联盟关系。公共提供商是一种向公众提供即时消息、状态和相关服务的组织。Microsoft Lync Server 2010 预先配置了以下三个公共提供商，但未启用：Yahoo!、AOL 和 MSN。
语法
New-CsPublicProvider -Identity <XdsGlobalRelativeIdentity> -Enabled <$true | $false> -ProxyFqdn <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VerificationLevel <AlwaysVerifiable | AlwaysUnverifiable | UseSourceVerification>] [-WhatIf [<SwitchParameter>]]
详细说明
联盟是两个组织间建立信任关系以促进沟通的一种途径。建立联盟后，两个组织中的用户可相互发送即时消息、订阅状态通知以及在其他情况下使用 Microsoft Lync 2010 等 SIP 应用程序相互通信。在 Lync Server 2010 中可使用以下三种类型的联盟：1) 您的组织与其他组织之间的直接联盟；2) 您的组织与公共提供商之间的联盟；以及 3) 您的组织与第三方托管提供商之间的联盟。
公共提供商是一种向公众提供 SIP 通信服务的组织。与公共提供商建立联盟关系时，实际上就与任何具有该提供商托管的帐户的用户建立了联盟。例如，如果您与 MSN 联盟，则您的用户将能够与具有 MSN 即时消息帐户的任何人交换即时消息和状态信息。
要与公共提供商联盟，需要创建并启用新的公共提供商。（此外，公共提供商需要与您建立联盟关系。）通过 Set-CsPublicProvider 可修改任何已配置为在组织中使用的公共提供商的属性值。
请注意，如果边缘服务器配置为使用默认路由而不是 DNS 服务器路由，则您不能与公共提供商联盟。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权运行 New-CsPublicProvider cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsPublicProvider"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
字符串 |
要创建的公共提供商的唯一标识符。Identity 通常是提供相关服务的网站名称（例如 Yahoo!、AOL 或 MSN）。 标识在公共提供商之间必须唯一，并且在托管提供商之间也必须唯一。假定尝试创建了一个 Identity 为 Fabrikam 的新公共提供商。如果已存在具有该 Identity 的公共提供商或托管提供商，则命令将失败。 |
ProxyFqdn |
必需 |
Fqdn |
指定公共提供商使用的代理服务器的完全限定域名 (FQDN)（例如 proxyserver.fabrikam.com）。 代理的 FQDN 在公共提供商之间必须唯一，并且在托管提供商之间也必须唯一。例如，假定尝试创建一个代理 FQDN 为 proxyserver.fabrikam.com 的新公共提供商。如果已存在具有该代理 FQDN 的公共提供商或托管提供商，则此命令将失败。 |
Enabled |
必需 |
布尔值 |
指示您的组织与公共提供商之间的联盟关系是否处于活动状态。如果设置为 True，则组织中的用户将能够与公共提供商托管其帐户的用户交换即时消息和状态信息。如果设置为 False，则组织中的用户将无法与公共提供商托管其帐户的用户交换即时消息和状态信息。分别使用 Enable-CsPublicProvider 和 Disable-CsPublicProvider cmdlet 可随时启用和禁用联盟关系。 |
VerificationLevel |
字符串 |
指示发自公共提供商的信息如何（或是否）经过验证以确保这些消息是从该提供商发送的。必须将 VerificationLevel 设置为下面的某个值： AlwaysVerifiable。将接受所有据称发自此提供商的消息。如果在消息中未找到验证标头，则 Lync Server 2010 将添加该标头。此值为默认值。 AlwaysUnverifiable。将所有据称发自公共提供商的消息视为未经验证。只有在发送这些消息的人员位于接收人的联系人列表中时才会提交这些消息。例如，如果 Ken Myer 在您的联系人列表中，则您可以收到他发来的消息。如果 Pilar Ackerman 不在您的联系人列表中，则您将无法收到她发来的消息。 UseSourceVerification。使用公共提供商向消息添加的验证标头。如果缺少验证信息，则将拒绝消息。 |
|
Force |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
|
InMemory |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
|
WhatIf |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
|
Confirm |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。New-CsPublicProvider 不接受通过管道传递的输入。
返回类型
创建 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider 对象的新实例。
示例
-------------------------- 示例 1 ------------------------
New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True
示例 1 中显示的命令与 Identity 为 Fabrikam 的公共提供商创建新的联盟关系。除了指定 Identity，还必须设置另外两个属性值（及其对应的参数）：ProxyFqdn（设置为 proxyserver.fabrikam.com）和 Enabled（本例中设置为 True）。
-------------------------- 示例 2 ------------------------
$x = New-CsPublicProvider -Identity "Fabrikam" -ProxyFqdn "proxyserver.fabrikam.com" -Enabled $True -InMemory
$x.VerificationLevel = "AlwaysUnverifiable"
Set-CsPublicProvider -Instance $x
示例 2 介绍如何能够仅在内存中创建新公共提供商，修改该提供商的属性，然后将该虚拟提供商变为可在组织中使用的真实提供商。为此，示例中的第一个命令创建一个 Identity 为 Fabrikam 的公共提供商。除了加入必要的参数（Identity、ProxyFQDN 和 Enabled）之外，该命令还添加了 InMemory 参数；这样即仅在内存中创建提供商的实例，随后将该实例存储在名为 $x 的变量中。
在创建保存在内存中的提供商实例之后，示例中的第二个命令将修改虚拟提供商的 VerificationLevel。然后，最后一个命令使用 Set-CsPublicProvider 将虚拟提供商（存储在 $x 中）变为真实的公共提供商。如果不调用 Set-CsPublicProvider，则不会创建真实提供商。相反，在终止 Windows PowerShell 会话或删除变量 $x 时，虚拟提供商将消失。