Compartilhar via

  • Artigo

Remove-CsPresencePolicy

 

Tópico modificado em: 2012-03-26

Remove a política de presença especificada.

Sintaxe

Remove-CsPresencePolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

As informações de presença (que, entre outras coisas, permitem saber se um contato está disponível para participar de uma conversa do sistema de mensagens instantâneas) são inestimáveis. Entretanto, também há um custo associado às informações de presença: quanto mais inscrições de presença houver, mais largura de banda deverá ser dedicada à atualização das informações de presença. Se a largura de banda da rede for restrita, limite o número de inscrições de presença disponíveis aos usuários.

Os cmdlets CsPresencePolicy permitem gerenciar dois aspectos importantes das inscrições de presença: assinantes solicitados e inscrições de categoria. Quando se é adicionado à lista de contatos do Microsoft Lync 2010 de outra pessoa, o comportamento padrão é receber uma notificação pop-up informando que você foi adicionado àquela lista. Até que se feche a notificação pop-up, cada notificação conta como um assinante anunciado. A propriedade MaxPromptedSubscriber da política de presença permite especificar o número máximo de diálogos de notificações não-resolvidas que um usuário pode ter. (Se um usuário alcançar o número máximo, ele não receberá novas notificações de contato, pelo menos enquanto alguns desses diálogos não forem ignorados).

As assinaturas de categoria representam uma solicitação por uma categoria específica de informação; por exemplo, um aplicativo que solicita dados de calendário. A propriedade MaxCategorySubscription permite aos administradores colocarem um limite no número de assinaturas de categoria que um usuário pode ter.

Antes do lançamento do Microsoft Lync Server 2010, o assinante solicitado e as inscrições de categoria eram gerenciados globalmente. Com os cmdlets CsPresencePolicy, é possível gerenciar essas inscrições de presença nos escopos global, de site ou por usuário. Isto permite controlar o uso da largura de banda e garante que os usuários tenham acesso às informações de presença de que necessitam para desempenhar suas tarefas.

As políticas criadas no escopo de site ou por usuário podem ser removidas a qualquer momento, executando-se o cmdlet Remove-CsPresencePolicy. Esse cmdlet também pode ser executado em relação à política global; no entanto, se fizer isso, a política global não será removida de fato. O Lync Server 2010 não permite a remoção de políticas globais). Em vez disso, as duas propriedades da política global (MaxPromptedSubscriber e MaxCategorySubscription) serão redefinidas com os seus valores padrão.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsPresencePolicy localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsPresencePolicy"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

Identidade de Xds

Identificador exclusivo da política de presença a ser removida. Para remover uma política configurada no escopo de site, utilize uma sintaxe similar a esta: -Identity "site:Redmond". Para remover uma política configurada no escopo por usuário, utilize uma sintaxe similar a esta: -Identity "RedmondPresencePolicy".

Remove-CsPresencePolicy também pode ser executado na política global. Para fazer isso, utilize esta sintaxe: -Identity global. Nesse caso, no entanto, a política global não será removida. Em vez disso, as propriedades contidas na política serão redefinidas com os seus valores padrão.

Force

Opcional

Parâmetro de opção

Se houver, a política por usuário será excluída por Remove-CsPresencePolicy, mesmo se a política em questão estiver atribuída a, pelo menos, um usuário. Se não houver, será necessário confirmar a solicitação de exclusão antes que uma política que ainda esteja em uso seja removida.

WhatIf

Opcional

Parâmetro de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetro de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy. Remove-CsPresencePolicy aceita a entrada canalizada do objeto de política de presença.

Tipos de Retorno

Nenhuma. Em vez disso, Remove-CsPresencePolicy exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

Exemplo

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

Remove-CsPresencePolicy -Identity "RedmondPresencePolicy"

O comando anterior exclui a política de presença por usuário com a Identidade RedmondPresencePolicy.

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

Get-CsPresencePolicy -Filter "tag:*" | Remove-CsPresencePolicy

O comando exibido no Exemplo 2 remove todas as políticas de presença que tiverem sido configuradas no escopo de site. (Essas políticas possuem uma Identidade que começa com o prefixo "tag:"). Para realizar essa tarefa, o comando primeiramente utiliza Get-CsPresencePolicy e o parâmetro Filter, para retornar todas as políticas de presença por usuário. O valor de filtro "tag:*" limita os dados retornados às políticas cuja Identidade começar com o valor de cadeia de caracteres "tag:". Essa coleção filtrada será então canalizada para Remove-CsPresencePolicy, que excluirá cada política na coleção.

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

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 500} | Remove-CsPresencePolicy

O Exemplo 3 exclui todas as políticas de presença que permitirem mais de 500 assinantes solicitados. Para fazer isso, o comando chama primeiramente Get-CsPresencePolicy, sem qualquer parâmetro, para retornar uma coleção de todas as políticas de presença configuradas para uso na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as políticas cuja propriedade MaxPromptedSubscriber for maior do que 500. Por sua vez, essa coleção filtrada será canalizada para Remove-CsPresencePolicy, que excluirá todas as políticas de presença que permitirem mais de 500 assinantes solicitados.