Compartilhar via

  • Artigo

New-CsPresencePolicy

 

Tópico modificado em: 2012-03-25

Cria uma nova política de presença no escopo do site ou no escopo por usuário.

Sintaxe

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

Descrição Detalhada

As informações da presença (que, entre outras coisas, permitem que você saiba se um contato está disponível para participar de uma conversa de mensagem instantânea) são inestimáveis. No entanto, há também 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 dedicada para atualizar as informações de presença. Se a largura de banda for uma preocupação, talvez seja necessário limitar o número de inscrições de presença por usuário.

Os cmdlets CsPresencePolicy permitem gerenciar dois aspectos importantes das inscrições de presença: inscritos solicitados e assinaturas 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áxima de caixas de diálogo de notificação não-resolvidas por usuário. (se um usuário atingir o número máximo, ele não receberá novas notificações de contato, pelo menos não até algumas das caixas de diálogo serem resolvidas.)

As assinaturas de categoria representam uma solicitação para uma categoria específica de informações; por exemplo, um aplicativo que solicita dados do calendário. A propriedade MaxCategorySubscription permite que os administradores estipulem 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. Isso permite controlar a largura de banda e garantir que os usuários tenham acesso às informações de presença de que eles precisam para realizar seus trabalhos.

O cmdlet New-CsPresencePolicy permite criar políticas de presença personalizadas no escopo do site ou no escopo por usuário. As políticas criadas no escopo do site são aplicadas automaticamente a este site; as políticas criadas no escopo por usuário devem ser atribuídas aos usuários executando-se o cmdlet Grant-CsPresencePolicy. Observe que não é possível criar uma nova política de presença no escopo global, nem criar uma segunda política de presença em um site individual. (por exemplo, o site de Redmond pode hospedar apenas uma política de presença.)

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsPresencePolicy localmente: 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 "New-CsPresencePolicy"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Identidade de Xds

Identificador exclusivo para a nova política de presença. Para criar uma nova política por usuário, use uma sintaxe semelhante a esta: -Identity "RedmondPresencePolicy". Para criar uma nova política no escopo do site, use uma sintaxe semelhante a esta: -Identity "site:Redmond".

Observe que não é possível criar uma nova política de presença no escopo global. Além disso, o comando não funcionará se o site em questão já hospedar uma política de presença, ou se você tentar usar a Identidade de uma política por usuário que já existir.

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 assinaturas de categoria permitido a qualquer momento. A assinatura de categoria representa uma solicitação para uma categoria específica de informações; por exemplo, um aplicativo que solicita dados do calendário.

MaxCategorySubscription pode ser definido como qualquer valor inteiro entre 0 e 3000; o valor padrão é 1000.

MaxPromptedSubscriber

Opcional

Inteiro

O número máximo de inscritos promovidos que um usuário pode ter a qualquer momento. Por padrão, sempre que você for adicionado à lista de Contatos de outro usuário, uma caixa de diálogo de notificação aparecerá na tela, informando sobre esse fato e oferecendo a opção de realizar ações, como adicionar a pessoa à sua lista de contatos ou impedir que ela visualize a sua presença. Até que você realize uma ação e ignore a caixa de diálogo, cada notificação contará como um inscrito solicitado.

MaxPromptedSubscriber pode ser definido como qualquer valor inteiro entre 0 e 600. O valor padrão é 200. Se você definir este 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 qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

InMemory

Opcional

Parâmetro de opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

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

Tipos de Retorno

New-CsPresencePolicy cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Presence.PresencePolicy.

Exemplo

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

New-CsPresencePolicy -Identity "RedmondPresencePolicy" -MaxPromptedSubscriber 400 -MaxCategorySubscription 500

O comando mostrado no Exemplo 1 cria uma nova política de presença por usuário com a Identidade RedmondPresencePolicy. Neste exemplo, o valor da propriedade MaxPromptedSubscriber é definido como 400 e o valor da propriedade MaxCategorySubscription é definido como 500.

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

$x = New-CsPresencePolicy -Identity "RedmondPresencePolicy" -InMemory
$x.MaxPromptedSubscriber = 400
$x.MaxCategorySubscription = 500
Set-CsPresencePolicy -Instance $x

No Exemplo 2, uma nova política de presença por usuário será inicialmente criada na memória e, só depois, será convertida em uma política de presença real. Para fazer isso, o primeiro comando no exemplo cria uma política de presença com a identidade RedmondPresencePolicy e armazena esta política em uma variável denominada $x. O parâmetro InMemory garante que a política seja criada apenas na memória e não seja adicionada imediatamente ao Lync Server 2010.

Os comandos 2 e 3 são usados a seguir para configurar as propriedades MaxPromptedSubscriber e MaxCategorySubscription da política virtual. Depois que os valores da política tiverem sido definidos, a linha 4 utilizará Set-CsPresencePolicy e o parâmetro Instance, para criar uma política de presença real com base nas informações armazenadas em $x. Esta etapa final é crucial: se você não chamar Set-CsPresencePolicy, a política existirá apenas na memória e desaparecerá assim que você terminar a sessão do Windows PowerShell ou excluir a variável $x.