New-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 года.

New-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Tenant <Guid>] [-WhatIf [<SwitchParameter>]]

Команда в примере 1 создает новую коллекцию параметров push-уведомлений для веб-сайта Redmond и включает push-уведомления Apple Push Notification Service и Microsoft Push Notification Service. Последние включаются установкой в свойствах EnableApplePushNotificationService и EnableMicrosoftPushNotificationService значения True.

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

В примере 2 создается набор параметров конфигурации push-уведомлений для всех сайтов Skype для бизнеса Server 2015. Для этого сначала используется командлет Get-CsSite , возвращающий коллекцию всех сайтов Skype для бизнеса Server 2015. Затем эта коллекция передается в командлет ForEach-Object , который запускает командлет New-CsPushNotificationConfiguration для каждого сайта в коллекции и создает новый набор параметров push-уведомлений. Обратите внимание на то, что эта команда не может быть выполнена для сайтов, которые уже имеют коллекцию параметров push-уведомлений.

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

В примере 3 параметр InMemory применяется для создания коллекции параметров конфигурации push-уведомлений, изначально существующей только в памяти. Для этого в примере создается новая коллекция параметров (с идентификатором site:Redmond), которая сохраняется в переменной $x. Обратите внимание на то, что после выполнения первой команды коллекция остается только в памяти. После запуска командлета Get-CsPushNotificationConfiguration вы не увидите запись для сайта site:Redmond.

Две следующие команды устанавливают значение True для свойств EnableApplePushNotificationService и EnableMicrosoftPushNotificationService виртуальной коллекции параметров, что позволяет получать push-уведомления из службы push-уведомлений Apple и службы push-уведомлений Майкрософт. Затем последняя команда использует командлет Set-CsPushNotificationConfiguration для преобразования виртуальных параметров push-уведомлений в фактическую коллекцию параметров для сайта Redmond. Если командлет Set-CsPushNotificationConfiguration не вызывается, эти параметры остаются только в памяти и исчезают после окончания сеанса Windows PowerShell или удаления переменной $x.

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

Служба push-уведомлений Apple и служба push-уведомлений (Майкрософт) предоставляют пользователям возможность запуска 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 . Это позволяет администратору включать push-уведомления на определенных веб-сайтах (например, на Redmond), отключив уведомления на остальных сайтах.

По умолчанию право на локальный запуск командлета New-CsPushNotificationConfiguration имеют члены группы RTCUniversalServerAdmins.

 

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

Identity

Обязательный

Microsoft.Rtc.Management.Xds.XdsIdentity

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

-Identity "site:Redmond"

Обратите внимание, что данная команда не выполняется, если на сайте Redmond уже хранится коллекция параметров push-уведомлений.

Confirm

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

System.Management.Automation.SwitchParameter

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

EnableApplePushNotificationService

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

System.Boolean

Если установлено значение True, пользователи iPhone получают push-уведомления Apple Push Notification Service. Если установлено значение False, пользователи iPhone их не получают.

Значение по умолчанию — False.

EnableMicrosoftPushNotificationService

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

System.Boolean

Если установлено значение True, пользователи Windows Phone получают push-уведомления Microsoft Push Notification Service. Если установлено значение False, пользователи Windows Phone их не получают.

Значение по умолчанию — False.

Force

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

System.Management.Automation.SwitchParameter

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

InMemory

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

System.Management.Automation.SwitchParameter

Создает ссылку на объект, в действительности не фиксируя изменение объекта как постоянное. Если назначить выходной результат вызванной этим параметром команды переменной, можно вносить изменения в свойства ссылки на объект, а затем фиксировать эти изменения, вызывая командлет Set-, соответствующий данному командлету.

Tenant

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

System.Guid

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

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

Идентификатор каждого из клиентов можно получить с помощью следующей команды:

Get-CsTenant | Select-Object DisplayName, TenantID

WhatIf

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

System.Management.Automation.SwitchParameter

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

Нет. Командлет New-CsPushNotificationConfiguration не принимает входные данные из конвейера.

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

 
Показ: