New-CsPushNotificationConfiguration

 

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

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

语法

New-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-InMemory <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 作用域创建自定义推送通知设置。这样，管理员就能够在某些站点（例如 Redmond）中向用户提供推送通知，同时限制在其他站点使用这些通知。

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

参数

参数	必需	类型	描述
Identity	必需	Xds 标识	推送通知设置只能在 site 作用域创建。要为站点指定新的设置集合，请使用以下类似语法： -Identity "site:Redmond" 请注意，如果 Redmond 站点已承载推送通知设置的集合，则此命令将失败。
EnableApplePushNotificationService	可选	布尔值	设置为 True 时，iPhone 用户将从 Apple 推送通知服务接收推送通知。当设置为 False 时，iPhone 用户不会收到这些通知。 默认值为 False。
EnableMicrosoftPushNotificationService	可选	布尔值	设置为 True 时，Windows Phone 用户将从 Microsoft Lync Server 2010 推送通知服务接收推送通知。当设置为 False 时，Windows Phone 用户不会收到这些通知。 默认值为 False。
Tenant	可选	GUID	此参数专门用于 Microsoft Office 365。
InMemory	可选	开关参数	创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的命令的输出分配给某变量，则可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。
Force	可选	开关参数	禁止显示运行此命令时可能出现的任何非严重错误消息。
WhatIf	可选	开关参数	描述如果执行命令会发生什么情况（无需实际执行命令）。
Confirm	可选	开关参数	在执行命令之前提示您进行确认。

输入类型

无。New-CsPushNotificationConfiguration 不接受通过管道传递的输入。

返回类型

New-CsPushNotificationConfiguration 创建 Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration 对象的新实例。

示例

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

New-CsPushNotificationConfiguration -Identity "site:Redmond" -EnableApplePushNotificationService $True -EnableMicrosoftPushNotificationService -$True

示例 1 中显示的命令为 Redmond 站点创建新的推送通知设置集合，并启用来自 Apple 推送通知服务和 Microsoft Lync Server 2010 推送通知服务的推送通知。后一项操作是通过将 EnableApplePushNotificationService 和 EnableMicrosoftPushNotificationService 属性设置为 True 来实现的。

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

Get-CsSite | ForEach-Object {New-CsPushConfigurationNotification -Identity $_.Identity}

示例 2 说明如何为每个 Lync Server 站点创建一组推送配置设置。为此，此命令首先使用 Get-CsSite 返回所有 Lync Server 站点的集合。该集合随后通过管道传递到 ForEach-Object cmdlet，后者会选取集合中的每一站点，调用 New-CsPushNotificationConfiguration，然后为该站点创建一组新的推送通知配置设置。请注意，对于已承载推送通知配置设置集合的任何站点，此命令将失败。

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

$x = New-CsPushNotificationConfiguration -Identity "site:Redmond" -InMemory
$x.EnableApplePushNotificationService = $True 
$x.EnableMicrosoftPushNotificationService = $True
Set-CsPushNotificationConfiguration -Instance $x

上述示例演示了如何使用 InMemory 参数创建最初仅存在于内存中的推送通知配置设置集合。为此，该示例创建一个新的设置集合（Identity 为 site:Redmond），并将该集合存储在名为 $x 的变量中。请注意，在第一个命令执行之后，该集合仅存在于内存中；如果运行命令 Get-CsPushNotificationConfiguration，将看不到任何 site:Redmond 项。

在接下来的两个命令中，此虚拟设置集合的 EnableApplePushNotificationService 和 EnableMicrosoftPushNotificationService 属性均设置为 True，从而启用来自 Apple 推送通知服务和 Microsoft Lync Server 2010 推送通知服务的推送通知。最后，最后一个命令使用 Set-CsPushNotificationConfiguration 将虚拟推送通知设置转换为应用于 Redmond 站点的实际设置集合中。如果不调用 Set-CsPushNotificationConfiguration，这些设置将只保留在内存中；一旦终止 Windows PowerShell 会话或者删除变量 $x，这些设置便会消失。