Set-CsConferencingConfiguration
Tópico modificado em: 2012-04-23
Modifica uma coleção existente de definições de configuração de conferências. As definições de conferências determinam aspectos como o tamanho máximo permitido do conteúdo e dos folhetos da reunião, 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
Set-CsConferencingConfiguration [-Identity <XdsIdentity>] [-ClientAppSharingPort <UInt16>] [-ClientAppSharingPortRange <UInt32>] [-ClientAudioPort <UInt16>] [-ClientAudioPortRange <UInt32>] [-ClientFileTransferPort <UInt16>] [-ClientFileTransferPortRange <UInt32>] [-ClientMediaPort <UInt16>] [-ClientMediaPortRange <UInt32>] [-ClientMediaPortRangeEnabled <$true | $false>] [-ClientSipDynamicPort <UInt16>] [-ClientSipDynamicPortRange <UInt32>] [-ClientVideoPort <UInt16>] [-ClientVideoPortRange <UInt32>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
Set-CsConferencingConfiguration [-ClientAppSharingPort <UInt16>] [-ClientAppSharingPortRange <UInt32>] [-ClientAudioPort <UInt16>] [-ClientAudioPortRange <UInt32>] [-ClientFileTransferPort <UInt16>] [-ClientFileTransferPortRange <UInt32>] [-ClientMediaPort <UInt16>] [-ClientMediaPortRange <UInt32>] [-ClientMediaPortRangeEnabled <$true | $false>] [-ClientSipDynamicPort <UInt16>] [-ClientSipDynamicPortRange <UInt32>] [-ClientVideoPort <UInt16>] [-ClientVideoPortRange <UInt32>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-Instance <PSObject>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-Organization <String>] [-WhatIf [<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 de gerenciar as atividades dos usuários, os administradores precisam gerenciar o 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.
Ao se instalar o Microsoft Lync Server 2010, o sistema fornece a você uma coleção única de definições de configuração de conferências (a coleção global). Se precisar criar definições personalizadas para um site ou serviço, utilize o cmdlet New-CsConferencingConfiguration. Depois que essas definições personalizadas tiverem sido criadas, será possível modificar qualquer uma delas (assim como a coleção global), usando-se o cmdlet Set-CsConferencingConfiguration.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsConferencingConfiguration localmente: 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 "Set-CsConferencingConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Xds Identity |
Identificador exclusivo da coleção de definições de configuração de conferências a ser modificada. Para fazer referência à coleção global, use esta sintaxe: -Identity global. Para fazer referência a uma coleção configurada no escopo do site, use uma sintaxe semelhante a esta: -Identity "site:Redmond". Para fazer referência a uma coleção no escopo do serviço, utilize uma sintaxe similar a esta: -Identity "service:ConferencingServer:atl-cs-001.litwareinc.com". O Serviço de Webconferência é o único serviço que pode hospedar essas definições de configuração. Se esse parâmetro não for especificado, Set-CsConferencingConfiguration modificará automaticamente as definições globais. |
Instance |
Opcional |
Objeto ConfSettings |
Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais. |
ClientAppSharingPort |
Opcional |
Inteiro |
Representa o número da porta inicial usada para o compartilhamento de aplicativos. ClientAppSharingPort deve ser um número de porta com valor entre 1024 e 65535. O valor padrão é 5350. |
ClientAppSharingPortRange |
Opcional |
Inteiro |
Indica o número total de portas disponíveis para o compartilhamento de arquivos. (o valor padrão é 40). Para determinar as portas reais usadas para o compartilhamento de aplicativos, use esse valor e o valor de ClientAppSharingPort. Por exemplo, se ClientAppSharingPort for definido como 5350 e ClientAppSharingPortRange for definido como 3, as três portas seguintes estarão disponíveis para o compartilhamento de aplicativos: 5350; 5351; 5352. |
ClientAudioPort |
Opcional |
Inteiro |
Representa o número da porta inicial usada para o áudio do cliente. ClientAudioPort deve ser um número de porta com valor entre 1024 e 65535. O valor padrão é 5350. |
ClientAudioPortRange |
Opcional |
Inteiro |
Indica o número total de portas disponíveis para o áudio do cliente. (o valor padrão é 40). Para determinar as portas reais usadas para o áudio do cliente, use esse valor e o valor de ClientAudioPort. Por exemplo: se ClientAudioPort for definido como 5350 e ClientAudioPortRange for definido como 3, as três portas seguintes estarão disponíveis para o áudio do cliente: 5350; 5351; 5352. |
ClientFileTransferPort |
Opcional |
Inteiro |
Representa o número da porta inicial usada para a transferências de arquivos. ClientFileTransferPort deve ser um número de porta com valor entre 1024 e 65535. O valor padrão é 5350. |
ClientFileTransferPortRange |
Opcional |
Inteiro |
Indica o número total de portas disponíveis para a transferências de arquivos. (o valor padrão é 40). Para determinar as portas reais usadas para as transferências de arquivos, use esse valor e o valor de ClientFileTransferPort. Por exemplo: se ClientFileTransferPort for definido como 5350 e ClientFileTransferPortRange for definido como 3, as três portas seguintes estarão disponíveis para as transferências de arquivos: 5350; 5351; 5352. |
ClientMediaPort |
Opcional |
Inteiro |
Representa o número da porta inicial usada para a mídia do cliente. Use esse parâmetro para clientes do Microsoft Office Communicator 2007 R2. O ClientMediaPort deve ser um número de porta com valor entre 1024 e 65535. O valor padrão é 5350. |
ClientMediaPortRange |
Opcional |
Inteiro |
Indica o número total de portas disponíveis para a mídia do cliente (o valor padrão é 40). Use esse parâmetro para clientes do Office Communicator 2007 R2. Para determinar as portas reais usadas para a mídia do cliente, use esse valor e o valor de ClientMediaPort. Por exemplo: se ClientMediaPort for definido como 5350 e ClientMediaPortRange for definido como 3, as três portas seguintes estarão disponíveis para a mídia do cliente: 5350; 5351; 5352. |
ClientMediaPortRangeEnabled |
Opcional |
Booleano |
Quando definido como True, os clientes usarão o intervalo de portas especificado para efetuar o tráfego de mídia. Quando for definido como False (o valor padrão), qualquer porta disponível (desde a porta 1024 até a porta 65535) será usada para acomodar o tráfego de mídia. |
ClientSipDynamicPort |
Opcional |
Inteiro |
Representa o número da porta inicial usada para o tráfego SIP. ClientSipDynamicPort deve ser um número de porta com valor entre 1024 e 65535. O valor padrão é 7100. |
ClientSipDynamicPortRange |
Opcional |
Inteiro |
Indica o número total de portas disponíveis para o tráfego SIP. (o valor padrão é 3). Para determinar as portas reais usadas para o tráfego SIP, use esse valor e o valor de ClientSipDynamicPort. Por exemplo, se ClientSipDynamicPort for definido como 7100 e ClientSipDynamicPortRange for definido como 3, as três portas seguintes estarão disponíveis para a mídia do cliente: 7100; 7101; 7102. |
ClientVideoPort |
Opcional |
Inteiro |
Representa o número da porta inicial usada para o vídeo do cliente. ClientVideoPort deve ser um número de porta com valor entre 1024 e 65535. O valor padrão é 5350. |
ClientVideoPortRange |
Opcional |
Inteiro |
Indica o número total de portas disponíveis para o vídeo do cliente. (o valor padrão é 40). Para determinar as portas reais usadas para o vídeo do cliente, use esse valor e o valor de ClientVideoPort. Por exemplo: se ClientVideoPort for definido como 5350 e ClientVideoPortRange for definido como 3, as três portas seguintes estarão disponíveis para o vídeo do cliente: 5350; 5351; 5352. |
ConsoleDownloadExternalUrl |
Opcional |
Cadeia de caracteres |
URL onde os usuários externos podem baixar um cliente suportado como o Microsoft Lync 2010. Observe que esta configuração é aplicável apenas aos clientes herdados (como o Microsoft Office Communicator 2007 R2) que estão fazendo o login em um pool do Lync Server. |
ConsoleDownloadInternalUrl |
Opcional |
Cadeia de caracteres |
URL onde os usuários internos podem baixar um cliente suportado como o Microsoft Lync 2010. Observe que esta configuração é aplicável apenas aos clientes herdados (como o Microsoft Office Communicator 2007 R2) que estão fazendo o login em um pool do Lync Server. |
ContentGracePeriod |
Opcional |
TimeSpan |
Indica quanto tempo o conteúdo da conferência permanecerá no servidor após o término da conferência. ContentGracePeriod deve ser especificado usando-se o formato Dias.Horas:Minutos:Segundos. Por exemplo: para definir o período de cortesia do conteúdo como 30 dias, use essa sintaxe: -ContentGracePeriod 30.00:00:00. O período de cortesia do conteúdo pode ser definido como qualquer valor entre 30 minutos (00:30:00) e 180 dias (180.00:00:00). O valor padrão é 15 dias (15.00:00:00). |
HelpdeskExternalUrl |
Opcional |
Cadeia de caracteres |
URL para o qual serão direcionados os usuários externos que clicarem na Ajuda durante uma conferência. |
HelpdeskInternalUrl |
Opcional |
Cadeia de caracteres |
URL para o qual serão direcionados os usuários internos que clicarem na Ajuda durante uma conferência. |
MaxBandwidthPerAppSharingServiceMb |
Opcional |
Inteiro |
Indica a largura máxima de banda (em megabytes) destinada ao Serviço de Conferência para Compartilhamento de Aplicativos. MaxBandwidthPerAppSharingServiceMb pode ser definido com qualquer valor inteiro entre 50 e 100.000. O valor padrão é 375 megabytes. |
MaxContentStorageMb |
Opcional |
Inteiro |
Quantidade máxima de espaço de arquivos (em megabytes) permitida para o armazenamento do conteúdo da reunião. MaxContentStorageMb pode ser definido como qualquer valor inteiro entre 50 e 1024 (1 gigabyte). O valor padrão é 500 megabytes. |
Organization |
Opcional |
Cadeia de caracteres |
Nome da organização que hospeda a conferência. |
Force |
Opcional |
Parâmetro de opção |
Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando. |
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
Objeto Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings. Set-CsConferencingConfiguration aceita instâncias canalizadas do objeto de configuração de conferências.
Tipos de Retorno
Set-CsConferencingConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings.
Exemplo
Exemplo 1
Set-CsConferencingConfiguration -Identity global -Organization Litwareinc
No Exemplo 1, Set-CsConferencingConfiguration modifica a instância global das definições de conferências; nesse caso, o comando define o valor da propriedade Organization como sendo Litwareinc. Isso é feito incluindo-se o parâmetro Organization, seguido do nome da organização: Litwareinc.
Exemplo 2
Get-CsConferencingConfiguration | Set-CsConferencingConfiguration -Organization Litwareinc
O Exemplo 2 é uma extensão do primeiro exemplo. Neste caso, o comando modifica o valor da propriedade Organization de cada coleção de definições de configuração de conferências que estiver em uso. Para fazer isso, o comando utiliza inicialmente Get-CsConferencingConfiguration, para recuperar uma coleção de todas as definições de conferências. Esta coleção será então canalizada para Set-CsConferencingConfiguration, que tratará cada item na coleção, alterando o valor da propriedade Organization para Litwareinc.
Exemplo 3
Get-CsConferencingConfiguration -Filter site:* | Set-CsConferencingConfiguration -MaxContentStorageMb 50
O comando exibido no Exemplo 3 altera o valor da propriedade MaxContentStorageMb de todas as definições de configuração de conferências aplicadas no escopo de site. Para realizar isso, o comando primeiramente chama Get-CsConferencingConfiguration, juntamente com o parâmetro Filter. O valor de filtro "site:*" garante que apenas as definições cuja Identidade começar com os caracteres "site:" serão retornadas Essa coleção filtrada será então canalizada para Set-CsConferencingConfiguration, que modificará o valor da propriedade MaxContentStorageMb de cada item na coleção para 50.
Exemplo 4
Get-CsConferencingConfiguration | Where-Object {$_.MaxContentStorageMb -gt 100} | Set-CsConferencingConfiguration -MaxContentStorageMB 100
No Exemplo 4, todas as definições de configuração de conferência que permitem o armazenamento de conteúdo de mais de 100 megabytes são modificadas, definindo o armazenamento máximo de conteúdo como sendo 100 megabytes. Para realizar essa tarefa, o comando primeiramente chama Get-CsConferencingConfiguration, sem nenhum parâmetro, para retornar uma coleção de todas as definições de configuração de conferências em uso. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará as definições cuja propriedade MaxContentStorageMb for maior do que 100. Essa coleção filtrada será então canalizada para Set-CsConferencingConfiguration, que selecionará cada item na coleção e definirá o valor da propriedade MaxContentStorageMb como sendo 100.
Exemplo 5
Set-CsConferencingConfiguration -Identity site:Redmond -ContentGracePeriod "22:00:00"
O comando anterior recupera as definições de configuração de conferência do site de Redmond (-Identity site:Redmond) e modifica o valor da propriedade ContentGracePeriod, definindo o período de cortesia para 22 horas (22 horas: 00 minutos: 00 segundos).
Exemplo 6
Get-CsConferencingConfiguration | Where-Object {$_.Organization -ne "Fabrikam"} | Set-CsConferencingConfiguration -Organization Litwareinc
No Exemplo 6, serão modificadas todas as definições de configuração da conferência que não listarem Fabrikam como Organização; mais especificamente, será atribuída Litwareinc como nova organização a todas essas definições. Para realizar essa tarefa, o comando primeiramente chama Get-CsConferencingConfiguration sem nenhum parâmetro, que retorna uma coleção de todas as definições de configuração de conferências em uso na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará todas as definições cuja propriedade Organization não for igual a (-ne) Fabrikam. Esta coleção filtrada será então canalizada para Set-CsConferencingConfiguration; Set-CsConferencingConfiguration tratará cada item na coleção, alterando o valor da propriedade Organization para Litwareinc.
Consulte Também
Outros Recursos
Get-CsConferencingConfiguration
New-CsConferencingConfiguration
Remove-CsConferencingConfiguration