Get-CsPushNotificationConfiguration
Tópico modificado em: 2012-04-23
Recupera informações sobre as definições de configuração da notificação de envio por push atualmente em uso na organização. 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
Get-CsPushNotificationConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsPushNotificationConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
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.
O cmdlet Get-CsPushNotificationConfiguration permite retornar informações sobre as definições de configuração da notificação de envio por push em uso pela sua organização.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsPushNotificationConfiguration localmente: RTCUniversalServerAdmins.
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
XdsIdentity |
Indica o identificador exclusivo da coleção de configurações da notificação de envio por push que se deseja retornar. Para se referir às configurações globais, use esta sintaxe: -Identity global Para referir-se à coleção configurada no escopo do site, use a sintaxe semelhante a esta: -Identity site:Redmond Observe que você não pode usar curingas quando especificando uma Identity. Se for necessário usar curingas, inclua o parâmetro Filter, no lugar. Se esse parâmetro não for especificado, Get-CsPushNotificationConfiguration retornará uma coleção de todas as configurações da notificação de envio por push em uso na organização. |
Tenant |
Opcional |
GUID |
Esse parâmetro é reservado para uso como o Microsoft Office 365. |
Filter |
Opcional |
Cadeia de caracteres |
Permite usar caracteres curinga para retornar uma coleção (ou coleções) de definições de configuração da notificação de envio por push. Para retornar uma coleção de todas as configurações definidas no escopo do site, use esta sintaxe: -Filter site:* Para retornar uma coleção de todas as definições que tiverem o valor da cadeia de caracteres "Canada" em alguma posição de sua identidade (a única propriedade que se pode filtrar), utilize esta sintaxe: -Filter "*Canada*" |
LocalStore |
Opcional |
SwitchParameter |
Recupera os dados de configuração da notificação de envio por push da réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si. |
Tipos de Entrada
Get-CsPushNotificationConfiguration não aceita a entrada canalizada.
Tipos de Retorno
Get-CsPushNotificationConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsPushNotificationConfiguration
O comando anterior retorna informações sobre todas as definições da notificação de envio por push configuradas para uso na organização.
-------------------------- Exemplo 2 --------------------------
Get-CsPushNotificationConfiguration -Identity "site:Redmond"
O comando mostrado no Exemplo 2 retorna informações sobre uma única coleção de configurações de notificação de envio por push: as definições configuradas para o site Redmond.
-------------------------- Exemplo 3 --------------------------
Get-CsPushNotificationConfiguration -Filter "site:*"
No Exemplo 3, o comando retorna todas as configurações da notificação de envio por push atribuídas ao escopo do site. Para isso, o comando usa o parâmetro Filter e o valor de filtro "site:*"; esse valor de filtro retorna apenas as configurações com uma Identidade que comece com o valor da cadeia de caracteres "site:"
-------------------------- Exemplo 4 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService -eq $False}
O comando anterior retorna todas as configurações da notificação de envio por push, onde as notificações de envio por push para iPhones foram desabilitadas. Para fazer isso, o comando usa primeiramente o cmdlet 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á então canalizada para o cmdlet Where-Object, que selecionará as configurações nas quais a propriedade EnableApplePushNotificationService for igual a (-eq) False.
-------------------------- Exemplo 5 --------------------------
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService -eq $False -or $_.EnableMicrosoftPushNotificationService -eq $False}
No Exemplo 5, as informações são retornadas para todas as configurações da notificação de envio por push em que o Apple Push Notification Service e/ou o Lync Server 2010 Push Notification Service foram desabilitados. Para realizar essa tarefa, o comando primeiramente usa o cmdlet Get-CsPushNotificationConfiguration para retornar uma coleção de todas as configurações da notificação de envio por push que estiverem em uso. Essa coleção será canalizada para o cmdlet Where-Object, que selecionará somente as configurações que atenderem a um (ou os dois) seguintes critérios: 1) a propriedade EnableApplePushNotificationService é igual a (-eq) False; 2) a propriedade EnableMicrosoftPushNotificationService property é igual a False. O operador –or solicita que o Where-Object procure as configurações que atendem a um dos critérios. Para restringir os dados retornados para as configurações onde os dois serviços foram desabilitados, use o operador –and:
Get-CsPushNotificationConfiguration | Where-Object {$_.EnableApplePushNotificationService –eq $False –and $_.EnableMicrosoftPushNotificationService –eq $False}