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