Remove-CsPushNotificationConfiguration

 

Tópico modificado em: 2012-04-23

Exclui uma coleção existente de configurações 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

Remove-CsPushNotificationConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <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.

Essas configurações personalizadas poderão ser excluídas posteriormente usando o cmdlet Remove-CsPushNotificationConfiguration. Se você excluir as definições configuradas no escopo de site, os usuários nesse site serão gerenciados automaticamente pelas configurações globais da notificação de envio por push.

Observe que o Remove-CsPushNotificationConfiguration pode também ser executado nas configurações globais. No entanto, se você fizer isso, as configurações globais não serão removidas; em vez disso, as propriedades nas configurações globais serão redefinidas para seus valores padrão. Nesse caso, isso significa que as notificações de envio por push serão desabilitadas do Apple Push Notification Service e do Microsoft Lync Server 2010 Push Notification Service.

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

Parâmetros

Parâmetro	Obrigatório	Tipo	Descrição
Identity	Obrigatório	XdsIdentity	Identificador exclusivo da coleção de definições de configuração da notificação de envio por push a ser removida. Para remover a coleção global, use a seguinte sintaxe: -Identity global Observe que não é possível remover efetivamente as configurações globais; em vez disso, só é possível redefinir as propriedades para seus valores padrão. Para remover uma coleção de site, utilize uma sintaxe similar a esta: -Identity site:Redmond Não é possível usar curingas ao especificar uma Identidade de política.
Force	Opcional	SwitchParameter	Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.
Tenant	Opcional	GUID	Esse parâmetro é reservado para uso como o Microsoft Office 365.
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. Remove-CsPushNotificationConfiguration aceita instâncias canalizadas do objeto PushNotificationConfiguration.

Tipos de Retorno

Nenhum. Em vez disso, Remove-CsPushNotificationConfiguration exclui instâncias do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.PushNotificationConfiguration.PushNotificationConfiguration.

Exemplo

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

Remove-CsPushNotificationConfiguration -Identity "site:Redmond"

O comando mostrado no Exemplo 1 exclui a coleção de configurações da notificação de envio por push atribuídas ao site Redmond.

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

Get-CsPushNotificationConfiguration -Filter "site:*" | Remove-CsPushNotificationConfiguration

O comando anterior excluir todas as configurações da notificação de envio por push definidas no escopo de site. Para realizar essa tarefa, o cmdlet usa primeiro o cmdlet Get-CsPushNotificationConfiguration e o parâmetro Filter para retornar uma coleção de todas as configurações definidas no escopo de site. O valor de filtro "site:*" limita os dados retornados a políticas de acesso externo que tiverem uma identidade iniciada pelo valor da cadeia de caracteres "site:". As configurações de escopo de site serão canalizadas para o cmdlet Remove-CsPushNotificationConfiguration e excluídas por ele.

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

Get-CsPushNotificationConfiguration | Where-Object {$_.EnableMicrosoftPushNotificationService -eq $False} | Remove-CsPushNotificationConfiguration

O Exemplo 3 mostra como você pode remover todas as definições de configuração da notificação de envio por push nas quais as notificações do Microsoft Lync Server 2010 Push Notification Service foram desabilitadas. Para fazer isso, o comando primeiramente usa Get-CsPushNotificationConfiguration para retornar uma coleção de todas as configurações da notificação de envio por push em uso no momento. 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 Remove-CsPushNotificationConfiguration que, por sua vez, excluirá todos os itens da coleção.