Set-CsPushNotificationConfiguration

 

上一次修改主题： 2012-04-23

修改现有的推送通知配置设置集合。推送通知服务（Apple 推送通知服务和 Microsoft Lync Server 2010 推送通知服务）提供了一种将有关事件（例如新即时消息或新语音邮件）的通知发送到移动设备（例如 iPhone 和 Windows Phone）的方法，即使这些设备上的 Microsoft Lync 2010 应用程序当前处于暂停状态或在后台运行也是如此。

语法

Set-CsPushNotificationConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Set-CsPushNotificationConfiguration [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

详细说明

Apple 推送通知服务和 Microsoft Lync Server 2010 推送通知服务允许在 Apple iPhone 或 Windows Phone 上运行 Lync 2010 的用户接收有关 Lync 2010 事件的通知，即使 Lync 2010 处于暂停状态或在后台运行也是如此。例如，用户可以接收诸如以下事件的通知：

- 新即时消息会话或会议的邀请

- 新即时消息

- 新语音邮件

如果不使用推送通知服务，仅当 Lync 2010 处于前台或充当活动应用程序时，用户才会收到这些通知。

管理员能够为 iPhone 用户和/或 Windows Phone 用户启用或禁用推送通知。（默认情况下，为 iPhone 用户和 Windows Phone 用户禁用推送通知。）管理员可以使用 Set-CsPushNotificationConfiguration cmdlet 在 global 作用域启用或禁用推送通知。他们还可以使用 New-CsPushNotificationConfiguration cmdlet 在 site 作用域创建自定义推送通知设置。这些自定义设置还可以使用 Set-CsPushNotificationConfiguration cmdlet 进行修改。

使用推送通知配置设置，管理员只需管理两个属性值：EnableApplePushNotificationService（确定是否向 iPhone 用户发送推送通知）和 EnableMicrosoftPushNotificationService（确定是否向 Windows Phone 用户发送推送通知）。请注意，这两个属性不必设置为相同的值。例如，您可以允许向 Windows Phone 用户推送通知（通过将 EnableMicrosoftPushNotificationService 设置为 True），同时通过将 EnableApplePushNotificationService 设置为 False 来禁止向 iPhone 用户推送通知。

谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsPushNotificationConfiguration cmdlet：RTCUniversalServerAdmins。

参数

参数	必需	类型	描述
Identity	可选	Xds 标识	指示要修改的推送通知配置设置的 Identity。要引用全局设置，请使用以下语法： -Identity global 要引用站点设置，请使用以下类似语法： -Identity site:Redmond 请注意，指定 Identity 时不能使用通配符。
EnableApplePushNotificationService	可选	布尔值	设置为 True 时，iPhone 用户将从 Apple 推送通知服务接收推送通知。当设置为 False 时，iPhone 用户不会收到这些通知。 默认值为 False。
EnableMicrosoftPushNotificationService	可选	布尔值	设置为 True 时，Windows Phone 用户将从 Microsoft Lync Server 2010 推送通知服务接收推送通知。当设置为 False 时，Windows Phone 用户不会收到这些通知。 默认值为 False。
Instance	可选	推送配置对象	允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。
Tenant	可选	GUID	此参数专门用于 Microsoft Office 365。
Force	可选	开关参数	禁止显示运行此命令时可能出现的任何非严重错误消息。
WhatIf	可选	开关参数	描述如果执行命令会发生什么情况（无需实际执行命令）。
Confirm	可选	开关参数	在执行命令之前提示您进行确认。

输入类型

Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration。Set-CsPushNotificationConfiguration 接受通过管道传递的 PushNotificationConfiguration 对象的实例。

返回类型

无。Set-CsPushNotificationConfiguration 会修改 Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration 对象的现有实例。

示例

-------------------------- 示例 1 --------------------------

Set-CsPushNotificationService -Identity "site:Redmond" -EnableApplePushNotificationService $False

示例 1 中显示的命令为 Redmond 站点禁用来自 Apple 推送通知服务的推送通知。

-------------------------- 示例 2 --------------------------

Get-CsPushNotificationService -Filter "site:*" | Set-CsPushNotificationService -EnableApplePushNotificationService $False

上述命令为当前承载推送通知设置的所有网站禁用来自 Apple 推送通知服务的推送通知。为此，此命令首先使用 Get-CsPushNotificationConfiguration 和 Filter 参数返回在 site 作用域配置的所有推送通知设置；筛选器值“site:*”将返回的设置限制为其 Identity 以字符串值“site:”开头的那些设置。然后将该设置集合通过管道传递到 Set-CsPushNotificationConfiguration cmdlet，后者选取集合中的每一项，并将 EnableApplePushNotificationService 属性设置为 False。

-------------------------- 示例 3 --------------------------

Get-CsPushNotificationService | Where-Object {$_.EnableMicrosoftPushNotificationService -eq $False} | Set-CsPushNotificationService -EnableApplePushNotificationService $False

示例 3 演示您如何找到来自 Microsoft Lync Server 2010 推送通知服务的推送通知处于禁用状态的所有推送通知设置，然后为其中每个设置禁用来自 Apple 推送通知服务的推送通知。为了执行此任务，此命令首先使用 Get-CsPushNotificationConfiguration 返回组织当前使用的所有推送通知设置的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者仅选择 EnableMicrosoftPushNotificationService 属性等于 (-eq) False 的那些设置。之后将筛选出的集合通过管道传递给 Set-CsPushNotificationConfiguration，后者会选取该集合中的每一项，并将 EnableApplePushNotificationService 属性设置为 False。