Compartilhar via

  • Artigo

Grant-CsConferencingPolicy

 

Tópico modificado em: 2012-03-23

Atribui uma diretiva de conferência em escopo por usuário. As diretivas de conferência determinam os recursos e capacidades que podem ser usados em uma conferência. Isso inclui tudo, desde o fato da reunião poder ou não incluir áudio e vídeo IP até o número máximo de pessoas que podem participar de uma reunião.

Sintaxe

Grant-CsConferencingPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

A conferência é uma parte importante do Microsoft Lync Server 2010: uma conferência permite um grupo de usuários se reunir online para exibir slides e vídeos, compartilhar aplicativos, trocar arquivos e estabelecer comunicação e colaboração.

É importante que o administrador mantenha o controle sobre as conferências e suas configurações. Em alguns casos, há questões de segurança a serem consideradas: por padrão, qualquer um (incluindo usuários não autenticados) pode participar de reuniões e salvar os slides ou folhetos distribuídos durante essas reuniões. Em outros casos, poderá haver questões de largura de banda a serem consideradas: ter várias reuniões simultâneas, cada uma com centenas de participantes e com transmissões de vídeo e compartilhamento de arquivos, pode provocar problemas na sua rede. Além disso, ocasionalmente podem ocorrer problemas legais. Por exemplo, por padrão os participantes de uma reunião podem fazer anotações em conteúdo compartilhando; porém, essas anotações não são salvas quando a reunião é arquivada. Se sua organização tiver que manter um registro de todas as comunicações eletrônicas, pode ser preciso desabilitar as anotações.

Obviamente, uma coisa é ter que gerenciar as configurações das conferências, outra é gerenciar essas configurações. No Lync Server 2010, as conferências são gerenciadas por meio de diretivas de conferências. (Em versões anteriores do software, elas eram conhecidas como diretivas de reunião.) Como observado, as diretivas de conferência determinam os recursos e capacidades que podem ser usados em uma conferência; isso inclui tudo, desde o fato da conferência poder ou não incluir áudio e vídeo IP até o número máximo de pessoas que podem participar de uma reunião. As diretivas de conferência podem ser configuradas em escopo global, em escopo de site ou em escopo por usuário. Elas dão uma enorme flexibilidade aos administradores quando se trata de decidir quais capacidades serão disponibilizadas a quais usuários.

Quando uma diretiva de site é criada, essa diretiva é atribuída automaticamente ao site apropriado no momento de sua criação. Isso não acontece com as diretivas por usuário: elas não são atribuídas a ninguém quando são criadas. Em vez disso, é preciso usar Grant-CsConferencingPolicy para atribuir as diretivas de conferência por usuário explicitamente a um usuário ou conjunto de usuários.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Parâmetro User ID

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

Observe que o caractere curinga asterisco (*) pode ser usado para especificar a Identity do usuário. Por exemplo, a Identidade "* Smith" retorna todos os usuários com nome para exibição terminando com o valor de cadeia de caracteres " Smith".

PolicyName

Obrigatório

Cadeia de caracteres

"Name" é o nome da diretiva que será atribuída. PolicyName é apenas a Identidade da diretiva sem seu escopo (o prefixo tag:). Por exemplo, uma diretiva com identidade tag:Redmond tem PolicyName igual a Redmond; uma diretiva com identidade tag:RedmondConferencingPolicy tem PolicyName igual a RedmondConferencingPolicy.

Para remover a diretiva por usuário atribuída anteriormente a um usuário, defina o parâmetro PolicyName como $Null.

DomainController

Opcional

Cadeia de caracteres

Permite especificar o FQDN (nome de domínio totalmente qualificado) de um controlador de domínio a ser contatado na atribuição da nova diretiva. Se o parâmetro não for especificado, Grant-CsConferencingPolicy irá contatar o primeiro controlador de domínio disponível.

PassThru

Opcional

Parâmetros de opção

Permite passar um objeto de usuário pela pipeline que representa o usuário ao qual a diretiva está sendo atribuída. Por padrão, o cmdlet Grant-CsConferencingPolicy não passa objetos pela pipeline.

WhatIf

Opcional

Parâmetros de opção

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

Confirm

Opcional

Parâmetros de opção

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

Tipos de Entrada

Valor de cadeia de caracteres ou objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Grant-CsConferencingPolicy aceita entrada em pipeline de valores de cadeia de caracteres representando o parâmetro Identity de uma conta de usuário. O cmdlet também aceita entrada em pipeline de objetos de usuário.

Tipos de Retorno

Por padrão, Grant-CsConferencingPolicy não retorna objetos ou valores. No entanto, se o parâmetro PassThru for incluído, o cmdlet irá retornar instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.

Exemplo

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

Grant-CsConferencingPolicy -identity "Ken Myer" -PolicyName SalesConferencingPolicy

No Exemplo 1, Grant-CsConferencingPolicy é usado para atribuir a diretiva SalesConferencingPolicy ao usuário com identidade "Ken Myer".

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

Get-CsUser -OU "ou=Finance,dc=litwareinc,dc=com" | Grant-CsConferencingPolicy -PolicyName FinanceConferencingPolicy

No exemplo anterior, a diretiva de conferência FinanceConferencingPolicy é atribuída a todos os usuários que tenham contas na unidade organizacional Finance. Para atribuir a mesma diretiva a todos os usuários em uma OU (unidade organizacional) específica, o cmdlet Get-CsUser é usado para recuperar todas as contas dessa OU. Depois que todas as contas de usuário são recuperadas, essas informações são canalizadas para o cmdlet Grant-CsConferencingPolicy, que atribui a diretiva FinanceConferencingPolicy a todos os usuários da coleção.

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

Get-CsUser -OU "ou=Finance,dc=litwareinc,dc=com" | Grant-CsConferencingPolicy -PolicyName $Null

O Exemplo 3 representa uma variação do Exemplo 2: no caso, porém, quaisquer diretivas de conferência por usuário atribuídas anteriormente aos usuários na OU Finance não serão mais atribuídas a esses usuários. Para fazer isso, o comando chama Grant-CsConferencingPolicy e especifica um valor nulo ($Null) como valor do parâmetro PolicyName.

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

Get-CsUser -LdapFilter "Department=Human Resources" | Grant-CsConferencingPolicy -PolicyName HRConferencingPolicy

No comando anterior, a diretiva HRConferencingPolicy é atribuída a todos os usuários que trabalhem nos departamentos de recursos humanos (Human Resources). Para isso, o cmdlet Get-CsUser e o parâmetro LdapFilter são chamados para recuperar o conjunto apropriado de usuários; o valor de parâmetro "Department=Human Resources" limita os itens retornados às contas de usuário nas quais o atributo Department tenha sido definido como "Human Resources". Depois que as contas de usuário são recuperadas, a coleção é canalizada para Grant-CsConferencingPolicy, que atribui a diretiva HRConferencingPolicy a todos os usuários da coleção.