Compartilhar via

  • Artigo

Grant-CsPresencePolicy

 

Tópico modificado em: 2012-03-23

Concede uma política de presença por usuário a um usuário ou grupo de usuários.

Sintaxe

Grant-CsPresencePolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <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: 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 de política de presença permite especificar o número máximo de diálogos de notificação não-resolvidos 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.

Ao se criar uma política por usuário, ela não será atribuída automaticamente a ninguém. Em vez disso, as políticas de presença por usuário devem ser explicitamente atribuídas aos usuários (ou grupos de usuários), executando-se o cmdlet Grant-CsPresencePolicy.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Indica a identidade da conta do usuário à qual será atribuída a política de presença. A Identidade de usuário pode ser especificada usando-se um dos quatro formatos a seguir: 1) O endereço SIP do usuário, 2) o UPN (nome principal de usuário), 3) o nome de domínio e nome de logon do usuário, na forma domínio\logon (por exemplo: litwareinc\kenmyer) e 4) o nome de exibição do usuário no Active Directory (por exemplo: Ken Myer). As Identidades de usuário também podem ser especificadas usando-se o nome diferenciado do usuário no Active Directory.

Além disso, pode-se utilizar o caractere curinga asterisco (*) ao utilizar o nome de exibição como identidade do usuário. Por exemplo: a Identidade "* Smith" retornará todos os usuários com o nome de exibição que termine com o valor de cadeia de caracteres "Smith".

PolicyName

Obrigatório

Identidade da política por usuário a ser atribuída. Por exemplo: -PolicyName "RedmondPresencePolicy". PolicyName é a Identidade da política sem o prefixo "tag:" Por exemplo: uma política com a Identidade "tag:NorthAmericaPresencePolicy" possui PolicyName igual a "NorthAmericaPresencePolicy".

DomainController

Opcional

Nome de domínio totalmente qualificado (FQDN) do controlador a ser contatado ao se atribuir a política. Por exemplo: -DomainController atl-dc-001.litwareinc.com.

Se não for especificado, Grant-CsPresencePolicy contatará o controlador de domínio disponível mais próximo ao atribuir a política.

PassThru

Opcional

Permite passar um objeto de usuário através do pipeline que representa o usuário ao qual será atribuída a política. Por padrão, o cmdlet Grant-CsPresencePolicy não canaliza objetos.

WhatIf

Opcional

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

Confirm

Opcional

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

Tipos de Entrada

Valor de cadeia de caracteres ou objeto Microsoft.Rtc.Management.WritebleConfig.Policy.Presence.PresencePolicy. Grant-CsPresencePolicy aceita entrada canalizada de valores de cadeia de caracteres que representam a Identidade de uma conta de usuário. O cmdlet também aceita entradas canalizadas de objetos de usuário.

Tipos de Retorno

Por padrão, Grant-CsPresencePolicy não retorna objetos ou valores. No entanto, se você incluir o parâmetro PassThru, o cmdlet retornará instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

Exemplo

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

Grant-CsPresencePolicy -Identity "Ken Myer" -PolicyName "RedmondPresencePolicy"

O comando exibido no Exemplo 1 atribui a política de presença por usuário RedmondPresencePolicy a um único usuário: o usuário com a identidade Ken Myer.

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

Get-CsUser -OU "OU=Redmond,dc=litwareinc,dc=com" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"

No Exemplo 2, a política de presença RedmondPresencePolicy é atribuída a todos os usuários que têm contas na OU Redmond no Serviços de Domínio Active Directory (AD DS). Para fazer isso, o comando usa primeiramente Get-CsUser e o parâmetro OU para retornar uma coleção de todas as contas de usuário localizadas na OU Redmond (OU=Redmond,dc=litwareinc,dc=com). Esta coleção será então canalizada para Grant-CsPresencePolicy, que atribuirá a política RedmondPresencePolicy a cada usuário na coleção.

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

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName "RedmondPresencePolicy"

O comando anterior atribui a política RedmondPresencePolicy a todos os usuários que trabalharem na cidade de Redmond. Para realizar essa tarefa, o comando primeiramente utiliza Get-CsUser e o parâmetro LDAPFilter, para retornar uma coleção de todos os usuários que trabalham em Redmond; o valor de filtro "I=Redmond" limita os dados retornados aos usuários de Redmond (no idioma de busca LDAP, "l", a letra L minúscula, é uma abreviação de "localidade"). A coleção recuperada será então canalizada para Grant-CsPresencePolicy, que atribuirá a política RedmondPresencePolicy a cada usuário na coleção.

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

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsPresencePolicy -PolicyName $Null

O comando exibido no Exemplo 4, retira a atribuição de todas as políticas de presença por usuário previamente atribuídas aos usuários que trabalharem em Redmond. Ao se chamar Grant-CsPresencePolicy definindo-se o parâmetro PolicyName com um valor nulo ($Null), o cmdlet removerá quaisquer políticas de presença por usuário atribuídas aos usuários afetados pelo comando.