Compartilhar via

  • Artigo

Get-CsPresencePolicy

 

Tópico modificado em: 2012-05-21

Retorna informações sobre a políticas de presença configuradas para uso na organização.

Sintaxe

Get-CsPresencePolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsPresencePolicy [-Filter <String>] [-LocalStore <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 resolvidos.)

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.

O cmdlet Get-CsPresencePolicy permite retornar as informações sobre todas as políticas de presença configuradas para uso na organização.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsPresencePolicy localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo da política de presença a ser recuperada. Para retornar a política global, utilize a seguinte sintaxe: -Identity global. Para retornar uma política configurada no escopo de site, utilize uma sintaxe similar a esta: -Identity "site:Redmond". Para retornar uma política configurada no escopo por usuário, utilize uma sintaxe similar a esta: -Identity "RedmondPresencePolicy". Não é possível utilizar caracteres curinga ao se especificar a identidade.

Se nem o parâmetro Identity nem Filter for especificado, Get-CsPresencePolicy retornará todas as políticas de presença configuradas para uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao se especificar a (ou políticas) a ser retornada. Por exemplo, esta sintaxe retorna todas as políticas de presença configuradas no escopo de site: -Filter "site:*"

Os parâmetros Filter e Identity não podem ser usados no mesmo comando.

LocalStore

Opcional

Parâmetro de opção

Recupera os dados da política de presença da réplica local do Repositório de Gerenciamento Central em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsPresencePolicy não aceita a entrada canalizada.

Tipos de Retorno

Get-CsPresencePolicy retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

Exemplo

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

Get-CsPresencePolicy

O comando apresentado no Exemplo 1 retorna informações sobre todas as políticas de presença configuradas para uso na organização. Isto é feito chamando-se Get-CsPresencePolicy sem nenhum parâmetro.

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

Get-CsPresencePolicy -Identity "RedmondPresencePolicy"

O Exemplo 2 retorna uma única política de presença por usuário: a política com a identidade RedmondPresencePolicy.

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

Get-CsPresencePolicy -Filter "site:*"

O comando anterior retorna informações sobre todas as políticas de presença que tiverem sido configuradas no escopo de site. Para fazer isto, o comando usa o parâmetro Filter e o valor do filtro "site:*"; esse valor de filtro limita os dados retornados a todas as políticas de presença que tiverem uma Identity iniciada pelo valor de cadeia de caracteres "site.".

-------------------------- Exemplo 4 ------------------------

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -le 100}

No Exemplo 4, as informações é retornada para todas as políticas de presença que limitarem a 100 ou menos o número máximo de assinantes solicitados. Para realizar essa tarefa, o comando chama inicialmente Get-CsPresencePolicy sem qualquer parâmetro, retornando um conjunto de todas as políticas de presença configuradas para uso na organização. Esse conjunto será canalizado para o cmdlet Where-Object , que selecionará somente as políticas nas quais a propriedade MaxPromptedSubscriber for menor ou igual a 100.