Set-CsPushNotificationConfiguration

Skype for Business Server 2015
 

Дата изменения раздела:2017-03-28

Изменяет существующую коллекцию настроек конфигурации push-уведомлений. Служба push-уведомлений (Apple Push Notification Service и Microsoft Push Notification Service) предоставляет способ отправки уведомлений о событиях, таких как новые мгновенные сообщения или новые сообщения голосовой почты, на мобильные устройства, такие как iPhone и Windows Phone, даже если приложение Skype для бизнеса на этих устройствах в настоящее время приостановлено или работает в фоновом режиме. Данный командлет впервые появился в накопительном пакете обновления для Lync Server 2010 за ноябрь 2011 года.

Set-CsPushNotificationConfiguration [-Identity <XdsIdentity>] <COMMON PARAMETERS>
Set-CsPushNotificationConfiguration [-Instance <PSObject>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-Tenant <Guid>] [-WhatIf [<SwitchParameter>]]

Команда, показанная в примере 1, отключает push-уведомления от службы push-уведомлений Apple для сайта Redmond.

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

В примере 2 отключаются push-уведомления от службы push-уведомлений Apple для всех сайтов, на которых в настоящее время размещаются параметры push-уведомлений. Для этого команда сначала использует командлет Get-CsPushNotificationConfiguration и параметр Filter, чтобы получить все параметры push-уведомлений, настроенные на уровне сайта; значение фильтра "site:*" задает извлечение только тех параметров, значение свойства Identity которых начинается со строкового значения "site:". Затем эта коллекция параметров передается по конвейеру в командлет Set-CsPushNotificationConfiguration , который для свойства EnableApplePushNotificationService каждого элемента коллекции устанавливает значение False.

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

В примере 3 показывается, как можно найти все параметры push-уведомлений, в которых отключены push-уведомления от службы push-уведомлений Microsoft, а затем для каждого из этих параметров отключить также и push-уведомления от службы push-уведомлений Apple. Для выполнения этой задачи команда сначала использует командлет Get-CsPushNotificationConfiguration , чтобы получить коллекцию всех параметров push-уведомлений, в настоящее время используемых в организации. Затем эта коллекция передается по конвейеру в командлет Where-Object , выбирающий только те настройки, в которых значение свойства EnableMicrosoftPushNotificationService равно (-eq) False. Затем эта отфильтрованная коллекция по конвейеру передается в командлет Set-CsPushNotificationConfiguration , который для свойства EnableApplePushNotificationService каждого элемента отфильтрованной коллекции устанавливает значение False.

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

Службы push-уведомлений Apple Push Notification Service и Microsoft Push Notification Service позволяют пользователям запускать Skype для бизнеса на Apple iPhone или Windows Phone для получения уведомлений о событиях Skype для бизнеса Server 2015, даже когда работа Skype для бизнеса приостановлена или выполняется в фоновом режиме. Например, пользователи могут получить уведомление для следующих событий:

- приглашения на новый сеанс обмена мгновенными сообщениями или конференцию;

- новые мгновенные сообщения;

- новое сообщение голосовой почты.

При отсутствии службы push-уведомлений пользователи будут получать эти оповещения только в том случае, если Skype для бизнеса работает на переднем плане и является активным приложением.

Администраторы могут включить или отключить push-уведомления для пользователей iPhone и Windows Phone. (По умолчанию push-уведомления отключены как для пользователей iPhone, так и для пользователей Windows Phone.) Администраторы могут включить или отключить push-уведомления на глобальном уровне, используя командлет Set-CsPushNotificationConfiguration . Они также могут создать специальные настройки push-уведомлений, используя командлет New-CsPushNotificationConfiguration . Эти специальные настройки также могут быть изменены с помощью командлета Set-CsPushNotificationConfiguration .

Администраторы могут управлять значениями только двух свойств конфигурации push-уведомлений: EnableApplePushNotificationService, которое определяет, отправляются ли push-уведомления пользователям iPhone, и EnableMicrosoftPushNotificationService, которое определяет, отправляются ли push-уведомления пользователям Windows Phone. Обратите внимание, что для этих свойств не обязательно устанавливать одинаковые значения. Например, можно включить push-уведомления для пользователей Windows Phone (устанавливая для EnableMicrosoftPushNotificationService значение True) и одновременно отключить уведомления для пользователей iPhone, устанавливая для EnableApplePushNotificationService значение False.

 

Параметр Обязательный? Тип Описание

Confirm

Необязательный

System.Management.Automation.SwitchParameter

Запрашивает подтверждение перед выполнением команды.

EnableApplePushNotificationService

Необязательный

System.Boolean

Если значение равно True, пользователи iPhone будут получать push-уведомления от службы push-уведомлений Apple. Если значение равно False, пользователи iPhone не будут получать эти уведомления.

По умолчанию используется значение False.

EnableMicrosoftPushNotificationService

Необязательный

System.Boolean

Если значение равно True, пользователи Windows Phone будут получать push-уведомления от службы push-уведомлений Apple. Если значение равно False, пользователи Windows Phone не будут получать эти уведомления.

По умолчанию используется значение False.

Force

Необязательный

System.Management.Automation.SwitchParameter

Запрещает на время выполнения команды отображение любых сообщений о некритических ошибках.

Identity

Необязательный

Microsoft.Rtc.Management.Xds.XdsIdentity

Задает свойство Identity для изменяемых настроек конфигурации push-уведомлений. Чтобы указать глобальные настройки, используйте следующий синтаксис:

-Identity global

Чтобы указать настройки для сайта, используйте следующий синтаксис:

-Identity site:Redmond

Учтите, что при указании идентификатора Identity нельзя использовать подстановочные знаки.

Instance

Необязательный

Объект конфигурации push-уведомлений

Позволяет передать в командлет ссылку на объект вместо установки значений отдельных параметров.

Tenant

Необязательный

System.Guid

Глобальный уникальный идентификатор (GUID) учетной записи клиента Skype для бизнеса Online для изменяемых параметров push-уведомлений. Например:

-Tenant "38aad667-af54-4397-aaa7-e94c79ec2308"

Вернуть идентификаторы всех клиентов можно, выполнив эту команду:

Get-CsTenant | Select-Object DisplayName, TenantID

Если вы используете удаленный сеанс Windows PowerShell и подключены только к Skype для бизнеса Online, указывать параметр клиента "Tenant" не нужно — идентификатор клиента автоматически заполнится с учетом сведений о подключении. Параметр "Tenant" в первую очередь предназначен для использования в гибридном развертывании.

WhatIf

Необязательный

System.Management.Automation.SwitchParameter

Описывает, что произойдет после выполнения команды, без фактического выполнения самой команды.

Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.Командлет Set-CsPushNotificationConfiguration принимает конвейерные экземпляры объекта PushNotificationConfiguration.

Нет. Вместо этого командлет Set-CsPushNotificationConfiguration изменяет существующие экземпляры объекта Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.

 
Показ: