Compartilhar via


Get-CsConferencingConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as definições de configuração de conferências da organização. As definições de conferências determinam aspectos como o tamanho máximo permitido do conteúdo e dos folhetos da conferência, o período de cortesia do conteúdo (ou seja, o tempo que o conteúdo será armazenado antes de ser excluído) e os URLs dos downloads internos e externos do cliente suportado.

Sintaxe

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

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

Descrição Detalhada

Quando se trata de conferências, o gerenciamento e a administração são divididos entre dois conjuntos de cmdlets. Se quiser gerenciar os aspectos que os usuários podem ou não fazer (por exemplo: se eles podem convidar participantes anônimos para entrar em uma conferência, oferecer o compartilhamento de aplicativos em uma conferência ou transferir arquivos em uma conferência), será necessário usar os cmdlets CsConferencingPolicy.

Além das atividades do usuário, os administradores precisam gerenciar o Lync Server Serviço de Webconferência. Por exemplo: os administradores precisam realizar ações, como especificar o valor máximo de armazenamento de conteúdo alocado para uma única conferência e especificar o período de cortesia antes que o conteúdo da conferência seja automaticamente excluído. Também deve-se permitir que eles especifiquem as portas usadas para atividades como compartilhamento de aplicativos e transferência de arquivos.

Estas últimas atividades podem ser gerenciadas usando-se os cmdlets CsConferencingConfiguration. Estes cmdlets permitem gerenciar os próprios servidores. Os cmdlets CsConferencingConfiguration (que podem ser aplicados aos escopos globais, de site e de serviço) não são usados para especificar se um usuário pode ou não compartilhar aplicativos durante uma conferência. No entanto, se o compartilhamento de aplicativos for permitido, esses cmdlets permitem indicar quais portas deverão ser usadas para essa atividade. Da mesma forma, os cmdlets permitem especificar os limites de armazenamento e os períodos de validade, bem como os indicadores para URLs internos e externos nos quais os usuários podem obter ajuda e recursos relacionados às conferências.

O cmdlet Get-CsConferencingConfiguration permite aos administradores retornarem informações sobre todas as definições de configuração de conferências em uso nas suas organizações.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo da coleção de definições de configuração de conferências a ser recuperada. Para recuperar as definições globais, use essa sintaxe: -Identity global. Para recuperar as definições configuradas no escopo de site, utilize uma sintaxe similar a esta: -Identity "site:Redmond". Para recuperar as definições configuradas no escopo de serviço, utilize uma sintaxe similar a esta: -Identity "service:ConferencingServer:atl-cs-001.litwareinc.com".

Se esse parâmetro não for incluído, Get-CsConferencingConfiguration retornará todas as definições de configuração de conferências em uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curingas ao especificar a Identidade das definições de configuração de conferências a ser retornada. Por exemplo, esta sintaxe retorna todas as definições configuradas no escopo de site: -Filter "site:*" Esta sintaxe retorna todas as definições configuradas no escopo de serviço: -Filter "service:*".

Observe que não é possível utilizar os parâmetros Filter e Identity no mesmo comando.

LocalStore

Opcional

Parâmetro de opção

Recupera os dados de configuração de conferências na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsConferencingConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsConferencingConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings.

Exemplo

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

Get-CsConferencingConfiguration

O Exemplo 1 retorna informações sobre todas as definições de configuração de conferências em uso na organização. Isto é feito chamando-se Get-CsConferencingConfiguration sem qualquer parâmetro.

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

Get-CsConferencingConfiguration -Identity site:Redmond

No Exemplo 2, as informações de configuração de conferências são retornadas para o site de Redmond (-Identity site:Redmond). Como as Identidades são exclusivas, esse comando sempre retornará, no máximo, uma única coleção de definições de configuração de conferências.

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

Get-CsConferencingConfiguration -Filter "site:*"

O comando exibido no Exemplo 3 retorna informações sobre todas as definições de configuração de conferências que tiverem sido aplicadas no escopo de site. Para realizar isso, chama-se Get-CsConferencingConfiguration, juntamente com o parâmetro Filter. O valor de filtro "site:*" garante que apenas as definições cuja Identidade começar com o valor de cadeia de caracteres "site:" serão retornadas.

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

Get-CsConferencingConfiguration | Where-Object {$_.Organization -ne "Litwareinc"}

O comando anterior retorna informações sobre todas as definições de configuração de conferências nas quais a organização não estiver definida como Litwareinc. Para realizar essa tarefa, o comando primeiramente chama Get-CsConferencingConfiguration, sem qualquer parâmetro, retornando uma coleção de todas as definições de configuração de conferências usadas na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade Organization não for igual a Litwareinc.

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

Get-CsConferencingConfiguration | Where-Object {$_.MaxContentStorageMB -gt 100}

No Exemplo 5, retornam-se apenas informações sobre as definições de configuração de conferências cujo espaço máximo de armazenamento de conteúdo for maior que 100 megabytes. Para fazer isso, o comando primeiramente chama Get-CsConferencingConfiguration, sem qualquer parâmetro, para retornar uma coleção de todas as definições de configuração de conferências. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará as definições cujo espaço de armazenamento de conteúdo for maior do que 100 megabytes.