Get-CsPushNotificationConfiguration
上一次修改主题： 2012-04-23
检索有关组织中当前使用的推送通知配置设置的信息。推送通知服务（Apple 推送通知服务和 Microsoft Lync Server 2010 推送通知服务）提供了一种将有关事件（例如新即时消息或新语音邮件）的通知发送到移动设备（例如 iPhone 和 Windows Phone）的方法，即使这些设备上的 Microsoft Lync 2010 应用程序当前处于暂停状态或在后台运行也是如此。
语法
Get-CsPushNotificationConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsPushNotificationConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
详细说明
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 作用域创建自定义推送通知设置。
Get-CsPushNotificationConfiguration cmdlet 提供了一种返回有关组织中当前正在使用的推送通知配置设置的信息的方法。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsPushNotificationConfiguration cmdlet：RTCUniversalServerAdmins。
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
指示要返回的推送通知设置集合的唯一标识符。要引用全局设置，请使用以下语法： -Identity global 要引用在 site 作用域配置的集合，请使用以下类似语法： -Identity site:Redmond 请注意，指定 Identity 时不能使用通配符。如果需要使用通配符，请改用 Filter 参数。 如果未指定此参数，则 Get-CsPushNotificationConfiguration 将返回组织中使用的所有推送通知配置设置的集合。 |
Tenant |
可选 |
GUID |
此参数专门用于 Microsoft Office 365。 |
Filter |
可选 |
字符串 |
使您能够使用通配符，以便返回一个或多个推送通知配置设置集合。要返回在 site 作用域配置的所有设置的集合，请使用以下语法： -Filter site:* 要返回其 Identity（唯一可以筛选的属性）中某位置包含字符串值“Canada”的所有设置的集合，请使用以下语法： -Filter "*Canada*" |
LocalStore |
可选 |
开关参数 |
从中央管理存储的本地副本，而不是从中央管理存储本身检索推送通知配置数据。 |
输入类型
Get-CsPushNotificationConfiguration 不接受通过管道传递的输入。
返回类型
Get-CsPushNotificationConfiguration 返回 Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Get-CsPushNotificationConfiguration
上述命令返回有关配置为在组织中使用的所有推送通知设置的信息。
-------------------------- 示例 2 --------------------------
Get-CsPushNotificationConfiguration -Identity "site:Redmond"
示例 2 中显示的命令返回有关单个推送通知设置集合的信息：为 Redmond 站点配置的设置。
-------------------------- 示例 3 --------------------------
Get-CsPushNotificationConfiguration -Filter "site:*"
在示例 3 中，命令返回分配给 site 作用域的所有推送通知设置。为此，此命令使用 Filter 参数和筛选器值“site:*”；该筛选器值仅返回其 Identity 以字符串值“site:”开头的设置。
-------------------------- 示例 4 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService -eq $False}
上述命令返回已禁用 iPhone 的推送通知的所有推送通知设置。为此，此命令首先使用 Get-CsPushNotificationConfiguration cmdlet 返回组织中当前使用的所有推送通知设置的集合。该集合随后通过管道传递到 Where-Object cmdlet，后者仅选取 EnableApplePushNotificationService 属性等于 (-eq) False 的那些设置。
-------------------------- 示例 5 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService -eq $False -or $_.EnableMicrosoftPushNotificationService -eq $False}
在示例 5 中，将返回已禁用 Apple 推送通知服务和/或 Lync Server 2010 推送通知服务的所有推送通知设置的信息。为执行此任务，此命令首先使用 Get-CsPushNotificationConfiguration cmdlet，以便返回当前正在使用中的所有推送通知设置的集合。该集合随后通过管道传递到 Where-Object cmdlet，后者仅挑选满足以下一个（或两个）条件的设置：1) EnableApplePushNotificationService 属性等于 (-eq) False；2) EnableMicrosoftPushNotificationService 属性等于 False。–or 运算符指示 Where-Object 查找满足任一条件的设置。要将返回的数据限制为两个服务均被禁用的设置，请改用 –and 运算符：
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService –eq $False –and $_.EnableMicrosoftPushNotificationService –eq $False}