Compartilhar via

  • Artigo

Set-CsPresencePolicy

 

Tópico modificado em: 2012-03-25

Modifica uma diretiva de presença existente.

Sintaxe

Set-CsPresencePolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]

Set-CsPresencePolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxCategorySubscription <UInt16>] [-MaxPromptedSubscriber <UInt16>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

As informações de presença (que, dentre outras coisas, permitem que você saiba se há um contato disponível para fazer parte de uma conversa do sistema de mensagens instantâneas) são imprescindíveis. Porém, ao mesmo tempo, existe um custo associado às informações de presença: quanto mais inscrições de presença você tiver, mais largura de banda de rede deverá ser destinada à atualização das informações de presença. Se largura de banda de rede for uma preocupação, você talvez queira limitar o número de inscrições de presença de um usuário.

Os cmdlets CsPresencePolicy permitem gerenciar dois aspectos importantes das inscrições de presença: assinantes avisados e inscrições de categoria. Quando você é adicionado à lista de contatos do Microsoft Lync 2010 de outra pessoa, o comportamento padrão é receber uma notificação pop-up informando a adição a essa lista. Até que o pop-up seja fechado, cada notificação é considerada um assinante avisado. A propriedade MaxPromptedSubscriber da diretiva de presença permite especificar o número máximo de caixas de diálogo de notificação não resolvidas que um usuário pode ter. (Se atingir o valor máximo, um usuário não receberá novas notificações de contato, pelo menos não até que algumas dessas caixas de diálogo tenham sido resolvidas.)

As inscrições de categoria representam uma solicitação de uma categoria de informação específica; por exemplo, um aplicativo solicitando dados do calendário. A propriedade MaxCategorySubscription permite aos administradores impor um limite quanto ao número de inscrições de categoria que um usuário pode ter.

Antes do lançamento do Microsoft Lync Server 2010, o assinante avisado e as inscrições de categoria eram gerenciados globalmente. Com os cmdlets CsPresencePolicy, agora é possível gerenciar essas inscrições de presença no escopo global, de site ou por usuário. Isso permite controlar o uso da largura de banda ao mesmo tempo em que garante que os usuários tenham acesso às informações de presença de que precisam para fazer seu trabalho.

O cmdlet Set-CsPresencePolicy permite modificar qualquer uma das diretivas de presença configuradas para uso na organização. A simples modificação de uma diretiva de presença significa a alteração da propriedade MaxPromptedSubscriber e/ou da propriedade MaxCategorySubscription.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsPresencePolicy localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identificador exclusivo da diretiva de presença a ser modificada. Para modificar a diretiva global, use esta sintaxe: -Identity global. Para modificar uma diretiva no escopo do site, use uma sintaxe semelhante a esta: -Identity "site:Redmond". Para modificar uma diretiva segundo o usuário, use uma sintaxe como esta: -Identity "RedmondPresencePolicy".

Instance

Opcional

Objeto de política de presença

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

Description

Opcional

Cadeia de caracteres

Permite aos administradores fornecer texto adicional para acompanhar a política de presença. Por exemplo, Descrição deve incluir informações sobre os usuários aos quais a política deve ser atribuída.

MaxCategorySubscription

Opcional

Inteiro

O número máximo de inscrições de categoria permitido em um dado momento. Uma inscrição de categoria representa uma solicitação de uma categoria de informação específica; por exemplo, um aplicativo solicitando dados do calendário.

MaxCategorySubscription pode ser definido como qualquer valor entre 0 e 3.000; o valor padrão é 1.000.

MaxPromptedSubscriber

Opcional

Inteiro

O número máximo de assinantes avisados que um usuário pode ter em um dado momento. Por padrão, sempre que você for adicionado à lista de Contatos de outro usuário, será exibida uma caixa de diálogo na tela informando esse fato e dando a chance de fazer coisas como adicionar a pessoa à sua própria lista de Contatos ou impedi-la de ver sua presença. Até você tomar a ação e fechar a caixa de diálogo, toda notificação é considerada um assinante avisado.

MaxPromptedSubscriber pode ser definido como qualquer valor inteiro entre 0 e 600, inclusive; o valor padrão é 200. Se você definir esse valor como 0, os usuários não receberão nenhuma notificação quando forem adicionados à lista de Contatos de outro usuário.

Force

Opcional

Parâmetro de opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

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. Set-CsPresencePolicy aceita entrada em pipeline do objeto de diretiva de presença.

Tipos de Retorno

Set-CsPresencePolicy não retorna nenhum objeto ou valor. Em vez disso, o cmdlet modifica instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

Exemplo

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

Set-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 300

O comando mostrado no Exemplo 1 modifica a diretiva de presença segundo o usuário RedmondPresencePolicy. Nesse exemplo, o valor da propriedade MaxPromptedSubscriber é definido como 300.

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

Get-CsPresencePolicy | Set-CsPresencePolicy -MaxPromptedSubscriber 300

O comando mostrado no Exemplo 2 é uma variação do comando usado no Exemplo 1; porém, no exemplo 2, a propriedade MaxPromptedSubscriber é definida como 300 para todas as diretivas de presença configuradas para uso na organização. Para isso, o comando chama inicialmente Get-CsPresencePolicy sem nenhum parâmetro; ele retorna uma coleção de todas as diretivas de presença configuradas para uso na organização. Em seguida, essa coleção é redirecionada para Set-CsPresencePolicy, que muda o valor de MaxPromptedSubscriber de cada diretiva na coleção para 300.

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

Get-CsPresencePolicy | Where-Object {$_.MaxPromptedSubscriber -gt 300} | Set-CsPresencePolicy -MaxPromptedSubscriber 300

O Exemplo 3 mostra como é possível configurar as diretivas de presença na organização para garantir que nenhuma diretiva permita mais de 300 assinantes avisados. Para realizar essa tarefa, o comando chama inicialmente Get-CsPresencePolicy sem nenhum parâmetro para retornar uma coleção de todas as diretivas de presença na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que seleciona apenas as diretivas nas quais o valor da diretiva MaxPromptedSubscriber seja maior do que 300. A coleção filtrada é redirecionada para Set-CsPresencePolicy, que seleciona cada diretiva da coleção e define o número máximo de assinantes avisados como 300. Dessa forma, nenhuma diretiva permitirá mais de 300 assinantes avisados, embora algumas diretivas possam permitir menos de 300 assinantes.