New-CsPushNotificationConfiguration

 

Tópico modificado em: 2012-04-23

Cria uma nova coleção de definições de configuração da notificação de envio por push no escopo de site. 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

New-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-EnableApplePushNotificationService <$true | $false>] [-EnableMicrosoftPushNotificationService <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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. Isso fornece aos Administradores a capacidade de fornecer notificações de envio por push a usuários em alguns sites (por exemplo, Redmond) enquanto restringe o uso dessas notificações em outros sites.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsPushNotificationConfiguration localmente: RTCUniversalServerAdmins.

Parâmetros

Parâmetro	Obrigatório	Tipo	Descrição
Identity	Obrigatório	XdsIdentity	As configurações da notificação de envio por push só podem ser criadas no escopo de site. Para especificar uma nova coleção de configurações para um site, use uma sintaxe semelhante a esta: -Identity "site:Redmond" Observe que o comando falhará se o site Redmond já hospedar uma coleção de configurações da notificação de envio por push.
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.
Tenant	Opcional	GUID	Esse parâmetro é reservado para uso como o Microsoft Office 365.
InMemory	Opcional	SwitchParameter	Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída de um comando for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando o cmdlet coincidente Set- deste cmdlet.
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

Nenhuma. New-CsPushNotificationConfiguration não aceita a entrada canalizada.

Tipos de Retorno

New-CsPushNotificationConfiguration cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.

Exemplo

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

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

O comando mostrado no Exemplo 1 cria uma nova coleção de configurações da notificação de envio por push para o site Redmond e habilita as notificações de envio por push do Apple Push Notification Service e do Microsoft Lync Server 2010 Push Notification Service. O último é feito configurando as propriedades EnableApplePushNotificationService e EnableMicrosoftPushNotificationService como True.

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

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

O Exemplo 2 mostra como você pode criar um conjunto de definições de configuração de push para cada um dos seus sites do Lync Server. Para fazer isso, o comando usa primeiro Get-CsSite para retornar uma coleção de todos os seus sites do Lync Server. Essa coleção será então canalizada para o cmdlet ForEach-Object, que selecionará cada site na coleção, chamará o New-CsPushNotificationConfiguration e criará um novo conjunto de definições de configuração da notificação de envio por push para esse site. Observe que o comando falhará para qualquer site que já hospedar uma coleção de configurações da notificação de envio por push.

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

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

O exemplo anterior demonstra o uso do parâmetro InMemory para criar uma coleção de definições de configuração da notificação de envio por push que existe inicialmente apenas na memória. Para isso, o exemplo cria uma nova coleção de configurações (com a Identity site:Redmond) e armazena essa coleção em uma variável chamada $x. Observe que, depois do primeiro comando ser executado, a coleção só existirá na memória; se executar o comando Get-CsPushNotificationConfiguration, você não verá uma entrada para site:Redmond.

Nos próximos dois comandos, as propriedades EnableApplePushNotificationService e EnableMicrosoftPushNotificationService desta coleção virtual de configurações são definidas como True, o que habilita as notificações de envio por push no Apple Push Notification Service e no Microsoft Lync Server 2010 Push Notification Service. Por fim, o último comando usa Set-CsPushNotificationConfiguration para transformar as configurações virtuais da notificação de envio por push em uma coleção de configurações reais aplicada ao site de Redmond. Se você não chamar Set-CsPushNotificationConfiguration, essas configurações continuarão apenas na memória e desaparecerão assim que sua sessão do Windows PowerShell for encerrada ou a variável $x for excluída.