Remove-CsPushNotificationConfiguration

 

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

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

语法

Remove-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 作用域创建自定义推送通知设置。

这些自定义设置以后可通过使用 Remove-CsPushNotificationConfiguration cmdlet 进行删除。如果您删除在 site 作用域配置的设置，则该站点中的用户将自动由全局推送通知设置进行管理。

请注意，也可以针对全局设置运行 Remove-CsPushNotificationConfiguration。但如果这样做，将不会删除全局设置，而是将全局集合中的所有属性重置为其默认值。在此示例中，这意味着将同时禁用来自 Apple 推送通知服务和 Microsoft Lync Server 2010 推送通知服务的推送通知。

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

参数

参数	必需	类型	描述
Identity	必需	Xds 标识	要删除的推送通知配置设置集合的唯一标识符。要删除全局集合，请使用以下语法： -Identity global 请注意，您无法实际删除全局设置，而只能将这些属性重置为默认值。 要删除一个站点集合，请使用以下类似语法： -Identity site:Redmond 指定策略 Identity 时不能使用通配符。
Force	可选	开关参数	禁止显示运行此命令时可能出现的任何非严重错误消息。
Tenant	可选	GUID	此参数专门用于 Microsoft Office 365。
WhatIf	可选	开关参数	描述如果执行命令会发生什么情况（无需实际执行命令）。
Confirm	可选	开关参数	在执行命令之前提示您进行确认。

输入类型

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

返回类型

无。Remove-CsPushNotificationConfiguration 会删除 Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration 对象的实例。

示例

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

Remove-CsPushNotificationConfiguration -Identity "site:Redmond"

示例 1 中显示的命令会删除分配给 Redmond 站点的推送通知设置的集合。

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

Get-CsPushNotificationConfiguration -Filter "site:*" | Remove-CsPushNotificationConfiguration

上述命令会删除在 site 作用域配置的所有推送通知设置。为了执行此任务，该 cmdlet 首先使用 Get-CsPushNotificationConfiguration cmdlet 和 Filter 参数返回在 site 作用域配置的所有设置集合；筛选器值“site:*”将返回的项限制为其 Identity 以字符串值“site:”开头的设置。site 作用域设置随后通过管道传递到 Remove-CsPushNotificationConfiguration cmdlet，并由其删除。

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

Get-CsPushNotificationConfiguration | Where-Object {$_.EnableMicrosoftPushNotificationService -eq $False} | Remove-CsPushNotificationConfiguration

示例 3 说明如何删除已禁用来自 Microsoft Lync Server 2010 推送通知服务的推送通知的所有推送通知配置设置。为此，此命令首先使用 Get-CsPushNotificationConfiguration 返回当前使用的所有推送通知设置的集合。然后将该集合通过管道传递给 Where-Object cmdlet，后者仅选择 EnableMicrosoftPushNotificationService 属性等于 (-eq) False 的那些设置。之后将筛选出的集合通过管道传递给 Remove-CsPushNotificationConfiguration，后者将删除该集合中的每一项。