Set-CsPushNotificationConfiguration

 

Tópico modificado em: 2012-04-23

Modifica uma coleção existente de definições de configuração da notificação de envio por push. O serviço de notificação de envio por push (Apple Push Notification Service e Microsoft Lync Server 2010 Push Notification Service) fornece uma maneira de enviar notificações sobre os eventos, como novas mensagens instantâneas ou nova caixa postal, para dispositivos móveis como iPhones e Windows Phones, mesmo quando o aplicativo Microsoft Lync 2010 nesses dispositivos estiver atualmente suspenso ou em execução em segundo plano.

Sintaxe

Set-CsPushNotificationConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Set-CsPushNotificationConfiguration [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Apple Push Notification Service e o Microsoft Lync Server 2010 Push Notification Service permitem que os usuários que executam o Lync 2010 em seu Apple iPhone ou Windows Phone recebam notificações sobre os eventos do Lync 2010, mesmo quando o Lync 2010 está suspenso ou em execução em segundo plano. Por exemplo, os usuários podem receber avisos para eventos, como estes:

- Convites para uma nova sessão de mensagens instantâneas ou conferência

- Novas mensagens instantâneas

- Nova caixa postal

Sem o serviço de notificação de envio por push, os usuários só receberiam esses avisos quando o Lync 2010 estivesse no primeiro plano e operando como o aplicativo ativo.

Os administradores tem a capacidade de habilitar ou desabilitar as notificações de envio por push para usuários do iPhone e/ou do Windows Phone. Por padrão, as notificações de envio por push estão desabilitadas para os usuários do iPhone e do Windows Phone. Os administradores podem habilitar ou desabilitar as notificações de envio por push no escopo global usando o cmdlet Set-CsPushNotificationConfiguration. Eles também podem criar configurações de notificação de envio por push personalizadas no escopo do site usando o cmdlet New-CsPushNotificationConfiguration. Essas definições personalizadas também podem ser modificadas usando o cmdlet Set-CsPushNotificationConfiguration.

Com as definições de configuração da notificação de envio por push, há somente dois valores de propriedade para os Administradores gerenciarem: EnableApplePushNotificationService, que determina se as notificações de envio por push são enviadas para os usuários do iPhone; e EnableMicrosoftPushNotificationService, que determina se as notificações de envio por push são enviadas para os usuários do Windows Phone. Observe que esses valores de propriedade não têm que ser definidos como o mesmo valor. Por exemplo, você poderia habilitar as notificações de envio por push para os usuários do Windows Phone (definindo EnableMicrosoftPushNotificationService como True) e, ao mesmo tempo, desabilitar as notificações para usuários do iPhone definindo EnableApplePushNotificationService como False.

Quem pode executar este cmdlet: por padrão, os membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsPushNotificationConfiguration localmente: RTCUniversalServerAdmins.

Parâmetros

Parâmetro	Obrigatório	Tipo	Descrição
Identity	Opcional	XdsIdentity	Indica a Identidade das definições de configuração da notificação de envio por push a ser modificada. Para se referir às configurações globais, use esta sintaxe: -Identity global Para se referir às configurações de site, use uma sintaxe semelhante a esta: -Identity site:Redmond Observe que você não pode usar curingas quando especificando uma Identity.
EnableApplePushNotificationService	Opcional	Booliano	Quando definido como True, os usuários do iPhone receberão as notificações de envio por push do Apple Push Notification Service. Quando definido como False, os usuários do iPhone não receberão essas notificações. O valor padrão é False.
EnableMicrosoftPushNotificationService	Opcional	Booliano	Quando definido como True, os usuários do Windows Phone receberão as notificações de envio por push do Microsoft Lync Server 2010 Push Notification Service. Quando definido como False, os usuários do Windows Phone não receberão essas notificações. O valor padrão é False.
Instance	Opcional	Objeto de configuração push	Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.
Tenant	Opcional	GUID	Esse parâmetro é reservado para uso como o Microsoft Office 365.
Force	Opcional	SwitchParameter	Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.
WhatIf	Opcional	SwitchParameter	Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.
Confirm	Opcional	SwitchParameter	Solicita confirmação antes da execução do comando.

Tipos de Entrada

Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration. Set-CsPushNotificationConfiguration aceita instâncias canalizadas do objeto PushNotificationConfiguration.

Tipos de Retorno

Nenhum. Em vez disso, Set-CsPushNotificationConfiguration modifica instâncias existentes do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.

Exemplo

-------------------------- Exemplo 1 --------------------------

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

O comando mostrado no Exemplo 1 desabilita as notificações de envio por push do Apple Push Notification Service para o site Redmond.

-------------------------- Exemplo 2 --------------------------

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

O comando anterior desabilita as notificações de envio por push do Apple Push Notification Service para todos os sites que hospedam atualmente as configurações da notificação de envio por push. Para fazer isso, o comando usa primeiro Get-CsPushNotificationConfiguration e o parâmetro Filter para retornar todas as configurações da notificação de envio por push definidas no escopo do site; o valor de filtro "site:*" limita as configurações retornadas àquelas que possuam Identidade começando com o valor de cadeia de caracteres "site:". Essa coleção de configurações será canalizada para o cmdlet Set-CsPushNotificationConfiguration, que selecionará cada item na coleção e definirá a propriedade EnableApplePushNotificationService como False.

-------------------------- Exemplo 3 --------------------------

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

O Exemplo 3 demonstra como você pode encontrar todas as configurações da notificação de envio por push nas quais o Microsoft Lync Server 2010 Push Notification Service está desabilitado e, em seguida, desabilitar as notificações de envio por push do Apple Push Notification Service para cada uma dessas configurações. Para fazer isso, o comando usa primeiro Get-CsPushNotificationConfiguration para retornar uma coleção de todas as configurações da notificação de envio por push em uso na organização. Essa coleção será canalizada para o cmdlet Where-Object, que selecionará somente as configurações nas quais a propriedade EnableMicrosoftPushNotificationService for igual a (-eq) False. Essa coleção filtrada será então canalizada para o Set-CsPushNotificationConfiguration, que selecionará cada item na coleção filtrada e definirá a propriedade EnableApplePushNotificationService como False.