New-CsConferencingConfiguration
Tópico modificado em: 2012-04-23
Cria uma nova coleção 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 conferência, o período de cortesia do conteúdo (ou seja, o tempo durante o qual o conteúdo será armazenado antes de ser excluído) e as URLs dos downloads internos e externos do cliente suportado. UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)
Sintaxe
New-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>] [-CloudPollServicePrimaryUrl <String>] [-CloudPollServiceSecondaryUrl <String>] [-Confirm [<SwitchParameter>]] [-ConsoleDownloadExternalUrl <String>] [-ConsoleDownloadInternalUrl <String>] [-ContentGracePeriod <TimeSpan>] [-Force <SwitchParameter>] [-HelpdeskExternalUrl <String>] [-HelpdeskInternalUrl <String>] [-InMemory <SwitchParameter>] [-MaxBandwidthPerAppSharingServiceMb <UInt64>] [-MaxContentStorageMb <UInt16>] [-MaxUploadFileSizeMb <UInt16>] [-Organization <String>] [-WhatIf [<SwitchParameter>]]
Exemplos
EXEMPLO 1
O comando exibido no Exemplo 1 cria uma nova coleção de definições de configuração de conferências para o site de Redmond (site:Redmond). Nesse exemplo, um parâmetro adicional (Organization) é incluído e usado para definir o valor da propriedade Organization para Litwareinc. Observe que este comando falhará se o site de Redmond já tiver uma coleção de definições de configuração de conferência. Isso ocorre porque só é possível haver uma coleção desse tipo por site.
New-CsConferencingConfiguration -Identity site:Redmond -Organization Litwareinc
EXEMPLO 2
No Exemplo 2, uma nova coleção de definições de configuração de conferências é inicialmente criada apenas em memória; essas definições virtuais são aplicadas apenas ao site de Redmond. Para isso, o primeiro comando no exemplo usa o cmdlet New-CsConferencingConfiguration para criar, em memória, uma nova coleção de definições armazenadas na variável $x. O parâmetro InMemory especifica que a coleção deve ser criada na memória, em vez de ser imediatamente aplicada ao site de Redmond.
Depois da criação da coleção, o segundo comando define o valor da propriedade Organization para Litwareinc. Finalmente, o terceiro comando usa Set-CsConferencingConfiguration para aplicar, de fato, as novas definições ao site de Redmond (observe que esse comando falhará se as definições de configuração de conferência já tiverem sido aplicadas ao site:Redmond). Se o cmdlet Set-CsConferencingConfiguration não for chamado, as novas definições nunca entrarão em vigor. Em vez disso, desaparecerão assim que a sessão do Windows PowerShell for encerrada ou a variável $x for excluída.
$x = New-CsConferencingConfiguration -Identity site:Redmond -InMemory
$x.Organization = "Litwareinc"
Set-CsConferencingConfiguration -Instance $x
Descrição Detalhada
Para conferências, o gerenciamento e a administração são divididos entre dois conjuntos de cmdlets. Se você deseja gerenciar o que os usuários podem ou não fazer (por exemplo: se podem convidar participantes anônimos para entrar em uma conferência, oferecer o compartilhamento de aplicativos ou transferir arquivos em uma conferência), será necessário usar os cmdlets CsConferencingPolicy.
Os administradores também 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. Eles também devem ter permissão para especificar as portas usadas para atividades como compartilhamento de aplicativos e transferência de arquivos.
Estas últimas atividades podem ser gerenciadas usando os cmdlets CsConferencingConfiguration. Esses 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 internas e externas nas quais os usuários podem obter ajuda e recursos relacionados às conferências.
Ao instalar o Lync Server, o sistema fornece uma coleção única de definições de configuração de conferências (a coleção global). Se for necessário criar definições personalizadas para um site ou serviço, utilize o cmdlet New-CsConferencingConfiguration. Observe que as novas configurações podem ser aplicadas apenas no escopo do site ou do serviço; não é possível criar uma nova coleção global de definições de configuração de conferências. Além disso, nenhum site ou serviço pode hospedar mais de uma coleção de definições. Se você tentar criar novas definições para o site de Redmond e ele já hospedar uma coleção de definições de configuração de conferências, o comando falhará.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsConferencingConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) às quais esse cmdlet foi atribuído (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsConferencingConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Microsoft.Rtc.Management.Xds.XdsIdentity |
Identificador exclusivo da coleção de definições de configuração de conferências a ser modificada. 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". Observe que o Serviço de Webconferência é o único serviço que pode hospedar essas definições de configuração. |
ClientAppSharingPort |
Opcional |
System.UInt16 |
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 |
System.UInt32 |
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 |
System.UInt16 |
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 |
System.UInt32 |
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 |
System.UInt16 |
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 |
System.UInt32 |
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 |
System.UInt16 |
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 |
System.UInt32 |
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 |
System.Boolean |
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 |
System.UInt16 |
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 |
System.UInt32 |
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 |
System.UInt16 |
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 |
System.UInt32 |
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. |
CloudPollServicePrimaryUrl |
Opcional |
System.String |
>URL principal da organização que fornece a pesquisa na nuvem. |
CloudPollServiceSecondaryUrl |
Opcional |
System.String |
URL de backup da organização que fornece a pesquisa na nuvem. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
Solicita confirmação antes da execução do comando. |
ConsoleDownloadExternalUrl |
Optional |
System.String |
URL onde os usuários externos podem baixar um cliente suportado como o Lync Server 15. 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 |
System.String |
URL onde os usuários internos podem baixar um cliente suportado como o Lync 15. 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 |
System.TimeSpan |
Indica quanto tempo o conteúdo da conferência permanecerá no servidor após o término da reunião. ContentGracePeriod deve ser especificado usando o formato Dias.Horas:Minutos:Segundos. Por exemplo, para definir o período de cortesia do conteúdo como 30 dias, use esta 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). |
Force |
Opcional |
System.Management.Automation.SwitchParameter |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando. |
HelpdeskExternalUrl |
Optional |
System.String |
URL para a qual serão direcionados os usuários externos que clicarem na Ajuda durante uma conferência. |
HelpdeskInternalUrl |
Opcional |
System.String |
URL para a qual serão direcionados os usuários internos que clicarem na Ajuda durante uma conferência. |
InMemory |
Opcional |
System.Management.Automation.SwitchParameter |
Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet. |
MaxBandwidthPerAppSharingServiceMb |
Opcional |
System.UInt64 |
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 |
System.UInt16 |
Quantidade máxima de espaço para arquivos (em megabytes) permitida para o armazenamento do conteúdo da conferência. MaxContentStorageMb pode ser definido como qualquer valor inteiro entre 50 e 1024 (1 gigabyte). O valor padrão é 500. |
MaxUploadFileSizeMb |
Opcional |
System.UInt16 |
Tamanho máximo total dos arquivos (incluindo folhetos e slides do PowerPoint) que podem ser usados em uma determinada conferência. Essa configuração é normalmente usada quando o conteúdo de referência está sendo arquivado no Microsoft Exchange Server: ao configurar um tamanho máximo de arquivo de carregamento, você garante que o conteúdo usado na conferência (e, dessa forma, o conteúdo que será arquivado) não excede o tamanho máximo de arquivo configurado para o Microsoft Exchange. O valor padrão é 500 megabytes. |
Organization |
Opcional |
System.String |
Nome da organização que hospeda a conferência. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Tipos de Entrada
Nenhuma. O cmdlet New-CsConferencingConfiguration não aceita a entrada por pipeline.
Tipos de Retorno
O cmdlet New-CsConferencingConfiguration cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.WebConf.ConfSettings.
Consulte Também
Outros Recursos
Get-CsConferencingConfiguration
Remove-CsConferencingConfiguration
Set-CsConferencingConfiguration