Compartilhar via

  • Artigo

Get-CsConferencingPolicy

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as diretivas de conferência que tenham sido configuradas para uso na organização. As diretivas de conferência determinam os recursos e capacidades que podem ser usados em uma conferência; isso inclui tudo, desde o fato de a 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.

Sintaxe

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

Get-CsConferencingPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

As conferências são uma parte importante do Microsoft Lync Server 2010: a 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 melhor 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.

O cmdlet Get-CsConferencingPolicy é uma maneira de retornar informações sobre todas as diretivas de conferência que tenham sido configuradas para uso na organização.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identidade Xds

Identificador único para a diretiva de conferência a ser recuperada. As diretivas de conferência podem ser configuradas em escopo global, em escopo de site ou em escopo por usuário. Para recuperar a diretiva global, use esta sintaxe: -Identity global. Para recuperar uma diretiva de site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Para recuperar uma diretiva por usuário, use uma sintaxe semelhante a esta: -Identity SalesConferencingPolicy.

Se esse parâmetro não for incluído, Get-CsConferencingPolicy vai retornar uma coleção de todas as diretivas de conferência configuradas para uso na organização.

Observe que curingas não podem ser usados para especificar Identity. Use o parâmetro Filter se quiser usar curingas ao especificar uma diretiva de conferência.

Filter

Opcional

Cadeia de caracteres

Permite o uso de caracteres curinga ao especificar uma ou mais diretivas de conferência a serem retornadas. Por exemplo, esta sintaxe retorna todas as diretivas configuradas em escopo de site: -Filter "site:*". Para retornar uma coleção de todas as diretivas configuradas em escopo por usuário, use esta sintaxe: -Filter "tag:*".

LocalStore

Opcional

Parâmetros de opção

Obtém os dados de diretiva de conferência a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsConferencingPolicy não aceita entrada em pipeline.

Tipos de Retorno

Get-CsConferencingPolicy retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Meeting.MeetingPolicy.

Exemplo

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

Get-CsConferencingPolicy

O exemplo anterior retorna uma coleção de todas as diretivas de conferência configuradas para uso na organização.

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

Get-CsConferencingPolicy -Identity Global

No Exemplo 2, o parâmetro Identity é usado para limitar as informações recuperadas a diretivas de conferência que tenham uma identidade igual a Global. Como as identidades de políticas precisam ser únicas, este comando retorna uma única diretiva: a diretiva de conferência Global.

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

Get-CsConferencingPolicy -Filter tag:*

O exemplo anterior usa o parâmetro Filter para retornar uma coleção de todas as diretivas de conferência que tenham sido configuradas em escopo por usuário. O valor curinga "tag:*" diz ao Windows PowerShell para limitar os dados retornados às diretivas de conferência que tenham uma identidade que comece com o valor de cadeia de caracteres "tag:".

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

Get-CsConferencingPolicy | Where-Object {$_.MaxMeetingSize -gt 100}

O Exemplo 4 retorna uma coleção de todas as diretivas de conferência nas quais a propriedade MaxMeetingSize seja maior do que 100. O comando começa usando o cmdlet Get-CsConferencingPolicy para retornar uma coleção de todas as diretivas de conferência configuradas para uso na organização. Essa coleção é então canalizada para o cmdlet Where-Object, que aplica um filtro que limita os dados retornados a diretivas nas quais a propriedade MaxMeetingSize seja maior do que 100.

-------------------------- Exemplo 5 --------------------------

Get-CsConferencingPolicy | Where-Object {$_.AllowExternalUsersToSaveContent -eq $True -and $_.AllowExternalUserControl -eq $True}

O comando anterior retorna todas as diretivas de conferência que atendam a dois critérios: a propriedade AllowExternalUsersToSaveContent tem que ser igual a True e a propriedade AllowExternalUserControl também tem que ser igual a True. Para fazer isso, o comando chama Get-CsConferencingPolicy sem especificar parâmetros adicionais; isso retorna uma coleção de todas as diretivas de conferência configuradas para uso na organização. Essa coleção é então encaminhada para Where-Object, que seleciona dentre essas diretivas apenas aquelas nas quais tanto AllowExternalUsersToSaveContent quanto AllowExternalUserControl sejam True. O operador -and diz ao Where-Object que um objeto precisa atender a todos os critérios especificados para ser retornado.

-------------------------- Exemplo 6 --------------------------

Get-CsConferencingPolicy | Where-Object {$_.AllowExternalUsersToSaveContent -eq $True -or $_.AllowExternalUserControl -eq $True}

O Exemplo 6 é uma variação do comando exibido no Exemplo 5. Neste caso, o comando retorna qualquer diretiva que atenda a pelo menos um dos (mas não necessariamente a ambos os) critérios especificados: ou a propriedade AllowExternalUsersToSaveContent é igual a True e/ou a propriedade AllowExternalUserControl é igual a True. Para fazer isso, o comando chama Get-CsConferencingPolicy sem especificar parâmetros adicionais; isso retorna uma coleção de todas as diretivas de conferência configuradas para uso na organização. Essa coleção é então encaminhada para Where-Object, que seleciona apenas as diretivas nas quais AllowExternalUsersToSaveContent e/ou AllowExternalUserControl sejam iguais a True. O operador -or diz ao Where-Object que um objeto precisa atender a apenas um dos critérios especificados para ser retornado.