Get-CsPublicProvider
上一次修改主题： 2012-03-23
返回有关配置为在组织中使用的公共提供商的信息。公共提供商是向普通公众提供即时消息、状态和相关服务的组织。Microsoft Lync Server 2010 附带了三个已配置但尚未启用的公共提供商：Yahoo!、AOL 和 MSN。
语法
Get-CsPublicProvider [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPublicProvider [-Filter <String>] [-LocalStore <SwitchParameter>]
详细说明
联盟是两个组织间建立信任关系以促进沟通的一种途径。建立联盟之后，两个组织中的用户可以相互发送即时消息，订阅状态通知以及使用 Microsoft Lync 2010 等 SIP 应用程序进行彼此通信。Lync Server 2010 允许建立三种类型的联盟：1) 在您的组织与其他组织之间直接建立联盟；2) 在您的组织与公共提供商之间建立联盟；以及 3) 在您的组织与第三方宿主提供商之间建立联盟。
公共提供商是为普通公众提供 SIP 通信服务的组织。当您与某个公共提供商建立联盟关系后，实际上便与具有该提供商所托管的帐户的所有用户都建立了联盟关系。例如，如果您与 MSN 联盟，则您的用户将能够与具有 MSN 即时消息帐户的任何人交换即时消息和状态信息。
为与公共提供商联盟，需要创建并启用一个新的公共提供商。（此外，公共提供商还需要与您建立联盟关系。）通过 Get-CsPublicProvider cmdlet，可以返回有关配置为在组织中使用的公共提供商的信息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsPublicProvider cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPublicProvider"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
字符串 |
要返回的公共提供商的唯一标识符。Identity 通常是提供相关服务的网站名称（例如 Yahoo!、AOL、MSN 等）。 指定 Identity 时不能使用通配符。要使用通配符返回一个或多个公共提供商，请改用 Filter 参数。 |
Filter |
可选 |
字符串 |
使您可以使用通配符值来返回一个或多个公共提供商。例如，要返回 Identity 以字母 Y 开头的所有公共提供商的集合，请使用以下语法：-Filter "Y*"。要返回其 Identity 中任意位置包含字符串值“Windows”的所有公共提供商的集合，请使用以下语法：-Filter "*Windows*"。 |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而不是从中央管理存储本身检索公共提供商数据。 |
输入类型
无。Get-CsPublicProvider 不接受通过管道传递的输入。
返回类型
返回 Microsoft.Rtc.Management.WritableConfig.Settings.Edge.DisplayPublicProvider 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsPublicProvider
示例 1 中显示的命令返回配置为在组织中使用的所有公共提供商的集合。调用不带任何其他参数的 Get-CsPublicProvider 将始终返回公共提供商的完整集合。
-------------------------- 示例 2 --------------------------
Get-CsPublicProvider -Identity "MSN"
在示例 2 中，返回 Identity 为 MSN 的所有公共提供商。由于公共提供商（和宿主提供商）的标识必须是唯一的，因此该命令将始终最多返回一项。
-------------------------- 示例 3 --------------------------
Get-CsPublicProvider -Filter W*
上述命令返回 Identity 以字母 W 开头的所有公共提供商。这是通过包含 Filter 参数和筛选器值“W*”实现的。
-------------------------- 示例 4 --------------------------
Get-CsPublicProvider | Where-Object {$_.Enabled -eq $False}
示例 4 中显示的命令返回当前已禁用的所有公共提供商的集合。为执行此操作，该命令首先调用 Get-CsPublicProvider 返回配置为在组织中使用的所有公共提供商的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，该 cmdlet 将仅选择 Enabled 属性等于 False 的提供商。
-------------------------- 示例 5 --------------------------
Get-CsPublicProvider | Where-Object {$_.VerificationLevel -ne "AlwaysVerifiable"}
上述命令返回 VerificationLevel 属性设置为 AlwaysUnverifiable 或 UseSourceVerification 的所有公共提供商。（验证级别可设置为 AlwaysUnverifiable、UseSourceVerification 或 AlwaysVerifiable。）为了执行此任务，该命令首先调用 Get-CsPublicProvider 返回配置为在组织中使用的所有公共提供商的集合。然后，将该集合通过管道传递到 Where-Object，后者将仅挑选出 VerificationLevel 属性不等于 AlwaysVerifiable 的提供商。其最终结果为：只有 VerificationLevel 属性设置为 AlwaysUnverifiable 或 UseSourceVerification 的提供商才被选中。