Testar notificações por push para smartphones no Lync Server 2013
Tópico última modificação: 15/03/2017
Agendamento de verificação |
Mensal |
Ferramenta de teste |
Windows PowerShell |
Permissões necessárias |
Quando executados localmente usando o Shell de Gerenciamento do Lync Server, os usuários devem ser membros do grupo de segurança RTCUniversalServerAdmins. Ao executar usando uma instância remota do Windows PowerShell, os usuários devem receber uma função RBAC que tenha permissão para executar o cmdlet Test-CsMcxPushNotification aplicativo. Para ver uma lista de todas as funções RBAC que podem usar esse cmdlet, execute o seguinte comando Windows PowerShell prompt: |
Descrição
O serviço de notificação por push (Serviço de Notificação por Push da Apple e o Serviço de Notificação por Push da Microsoft) pode enviar notificações sobre eventos como novas mensagens instantâneas ou nova caixa postal para dispositivos móveis, como iPhones e Windows Phones, mesmo que o cliente do Lync nesses dispositivos esteja suspenso ou em execução em segundo plano. O serviço de notificação por push é um serviço baseado em nuvem que está em execução em servidores Da Microsoft. Para aproveitar as notificações por push, você deve ser capaz de se conectar e ser autenticado pelo centro de limpeza de notificação por push. O Test-CsMcxPushNotification cmdlet permite que os administradores verifiquem se as solicitações de notificação por push podem ser roteadas por meio do servidor do Edge para a limpeza de notificação por push.
Executando o teste
Para testar o serviço de notificação por push, chame Test-CsMcxPushNotification cmdlet. Especifique o nome de domínio totalmente qualificado do servidor do Edge:
Test-CsMcxPushNotification -AccessEdgeFqdn "atl-edge-001.litwareinc.com"
Para obter mais informações, consulte o tópico de ajuda para o cmdlet Test-CsMcxPushNotification .
Determinando êxito ou falha
Se Test-CsMcxPushNotification êxito, o cmdlet retornará o resultado do teste Êxito:
TargetFqdn : atl-cs-001.litwareinc.com
Resultado: Êxito
Latência: 00:00:00
Erro:
Diagnóstico:
Se Test-CsMcxPushNotification não for possível se conectar ao centro de limpeza de notificação por push, o cmdlet normalmente não retornará um resultado de teste de Falha. Em vez disso, o comando geralmente falhará completamente. Por exemplo:
Test-CsMcxPushNotification: uma resposta 504 (tempo limite do servidor) foi recebida da rede e a operação falhou. Consulte os detalhes da exceção para obter mais informações.
Na linha:1 char:27
+ Test-CsMcxPushNotification <<<< -AccessEdgeFqdn lyncedge.mydomain.com
+ CategoryInfo: OperationStopped: (:) [Test-CsMcxPushNotification], FailureResponseException
+ FullyQualifiedErrorId : WorkflowNotCompleted,Microsoft.Rtc.Management.SyntheticTransactions.TestMcxPushNotificationCmdlet
Motivos pelos quais o teste pode ter falhado
Se o serviço de notificação por push falhar, isso geralmente indicará problemas de comunicação com o servidor de borda ou problemas de comunicação com a Casa de Limpeza de Notificação por Push. Se você encontrar problemas ao executar Test-CsMcxPushNotification, a primeira coisa que você deve fazer é verificar se o servidor de Borda está funcionando corretamente. Uma maneira de fazer isso é usar o cmdlet Test-CsAVEdgeConnectivity aplicativo:
$credential = Get-Credential "litwareinc\kenmyer"
Test-CsAVEdgeConnectivity -TargetFqdn "atl-cs-001.litwareinc.com" -UserSipAddress "sip:kenmyer@litwareinc.com" -UserCredential $credential
Essa verificação verifica se um usuário especificado pode se conectar ao servidor do Edge.
Se o servidor do Edge parece estar funcionando corretamente, isso geralmente significa que você não consegue se conectar à casa de limpeza de notificação por push. Por sua vez, isso normalmente significa que você não configurou o URI do clearinghouse corretamente ou que não tem um registro SRV dns que aponte para essa URL. Você pode verificar se o URI está definido com o valor correto (sip:push@push.lync.com) executando este comando:
Get-CsMcxConfiguration
Se a propriedade PushNotificationProxyUri estiver definida como algo diferente de sip:push@push.lync.com você poderá corrigir esse problema usando o cmdlet Set-McxConfiguration aplicativo. Por exemplo, esse comando define corretamente o URI em toda a organização:
Get-CsMcxConfiguration | Set-CsMcxConfiguration -PushNotificationProxyUri "sip:push@push.lync.com"
Para obter mais informações, consulte o tópico de ajuda para o cmdlet Set-CsMcxConfiguration .
Se o URI estiver configurado corretamente, a próxima etapa deverá ser verificar se você tem um registro SRV DNS que é resolvido para o domínio SIP e o servidor de borda. Para obter mais informações sobre como configurar esses registros, consulte o tópico de ajuda DNS Requirements for Mobility. Observe que a seguinte mensagem de erro geralmente indica um problema com registros DNS:
Uma resposta 504 (tempo limite do servidor) foi recebida da rede e a operação falhou. Consulte os detalhes da exceção para obter mais informações.
Também é possível que Test-CsMcxConfiguration com esta mensagem de erro:
Test-CsMcxPushNotification: a solicitação de notificação por push foi rejeitada.
Na linha:1 char:27
+ Test-CsMcxPushNotification <<<<
+ CategoryInfo: OperationStopped: (:) [Test-CsMcxPushNotification], SyntheticTransactionException
+ FullyQualifiedErrorId : WorkflowNotCompleted,Microsoft.Rtc.Management.SyntheticTransactions.TestMcxPushNotificationCmdlet
A mensagem "Solicitação de notificação por push foi rejeitada" normalmente ocorrerá se você tiver habilitado a filtragem de URL e estiver bloqueando os prefixos http: e https: . Você pode determinar quais prefixos estão sendo bloqueados usando um comando semelhante ao seguinte:
(Get-CsImFilterConfiguration -Identity Global).Prefixes
Se http: ou https: aparecer nos resultados, você deverá removê-los da lista de prefixos bloqueados para que as notificações por push funcionem. Isso pode ser feito usando comandos semelhantes a estes:
Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{remove="http:"}
Set-CsImFilterConfiguration -Identity site:Redmond -Prefixes @{remove="https:"}
Para obter mais informações, consulte o tópico de ajuda para o cmdlet Set-CsImFilterConfiguration.