Get-CsPushNotificationConfiguration

Syntax

Get-CsPushNotificationConfiguration
   [-Tenant <Guid>]
   [[-Identity] <XdsIdentity>]
   [-LocalStore]
   [<CommonParameters>]

Get-CsPushNotificationConfiguration
   [-Tenant <Guid>]
   [-Filter <String>]
   [-LocalStore]
   [<CommonParameters>]

Description

The Apple Push Notification Service and the Microsoft Push Notification Service enable users running Skype for Business on their Apple iPhone or Windows Phone to receive notifications about Skype for Business Server events even when Skype for Business is suspended or running in the background. For example, users can receive notice for events such as these:

• Invitations to a new instant messaging session or conference
• New instant messages
• New voice mail

Without the push notification service users would receive these notices only when Skype for Business was in the foreground and serving as the active application.

Administrators have the ability to enable or disable push notifications for iPhone users and/or Windows Phone users. (By default, push notifications are disabled for both iPhone users and Windows Phone users.) Administrators can enable or disable push notifications at the global scope by using the Set-CsPushNotificationConfiguration cmdlet. They can also create custom push notification settings at the site scope by using the New-CsPushNotificationConfiguration cmdlet.

The Get-CsPushNotificationConfiguration cmdlet provides a way for you to return information about the push notification configuration settings currently in use in your organization.

Examples

-------------------------- Example 1 --------------------------

Get-CsPushNotificationConfiguration

Skype for Business Server example 1 returns information about all the push notification settings configured for use in your organization.

-------------------------- Example 2 --------------------------

Get-CsPushNotificationConfiguration -Identity "site:Redmond"

Skype for Business Server example 2 returns information about a single collection of push notification settings: the settings configured for the Redmond site.

-------------------------- Example 3 --------------------------

Get-CsPushNotificationConfiguration -Filter "site:*"

In Skype for Business Server example 3, the command returns all the push notification settings assigned to the site scope. To do this, the command uses the Filter parameter and the filter value "site:*"; that filter value returns only those settings that have an Identity that begins with the string value "site:".

-------------------------- Example 4 --------------------------

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

In Skype for Business Server example 4 returns all the push notification settings where push notifications for iPhones have been disabled. To do this, the command first uses the Get-CsPushNotificationConfiguration cmdlet to return a collection of all the push notification settings currently in use in the organization. This collection is then piped to the Where-Object cmdlet, which picks out only those settings where the EnableApplePushNotificationService property is equal to (-eq) False.

-------------------------- Example 5 --------------------------

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

In Skype for Business Server example 5, information is returned for all the push notification settings where either the Apple Push Notification Service and/or the Microsoft Push Notification Service have been disabled. To carry out this task, the command first uses the Get-CsPushNotificationConfiguration cmdlet in order to return a collection of all the push notification settings currently in use. This collection is then piped to the Where-Object cmdlet, which picks out those settings which meet one (or both) of the following criteria: 1) the EnableApplePushNotificationService property is equal to (-eq) False; 2) the EnableMicrosoftPushNotificationService property is equal to False. The -or operator tells Where-Object to look for settings that meet either criteria:

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

To restrict the returned data to settings where both services have been disabled, use the -and operator instead:

Parameters

-Filter

-Identity

-LocalStore

-Tenant

Inputs

None

Outputs

Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration

Related Links

• Set-CsPushNotificationConfiguration
• New-CsPushNotificationConfiguration
• Remove-CsPushNotificationConfiguration