Set-CsConferencingPolicy
Tópico modificado em: 2012-10-18
Modifica uma diretiva de conferência existente. 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
Set-CsConferencingPolicy [-Identity <XdsIdentity>] [-AllowAnnotations <$true | $false>] [-AllowAnonymousParticipantsInMeetings <$true | $false>] [-AllowAnonymousUsersToDialOut <$true | $false>] [-AllowConferenceRecording <$true | $false>] [-AllowExternalUserControl <$true | $false>] [-AllowExternalUsersToRecordMeeting <$true | $false>] [-AllowExternalUsersToSaveContent <$true | $false>] [-AllowIPAudio <$true | $false>] [-AllowIPVideo <$true | $false>] [-AllowParticipantControl <$true | $false>] [-AllowPolls <$true | $false>] [-AllowUserToScheduleMeetingsWithAppSharing <$true | $false>] [-AppSharingBitRateKb <Int64>] [-AudioBitRateKb <UInt32>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableAppDesktopSharing <None | SingleApplication | Desktop>] [-EnableDataCollaboration <$true | $false>] [-EnableDialInConferencing <$true | $false>] [-EnableFileTransfer <$true | $false>] [-EnableP2PFileTransfer <$true | $false>] [-EnableP2PRecording <$true | $false>] [-EnableP2PVideo <$true | $false>] [-FileTransferBitRateKb <Int64>] [-Force <SwitchParameter>] [-MaxMeetingSize <UInt32>] [-MaxVideoConferenceResolution <CIF | VGA>] [-VideoBitRateKb <Int64>] [-WhatIf [<SwitchParameter>]]
Set-CsConferencingPolicy [-AllowAnnotations <$true | $false>] [-AllowAnonymousParticipantsInMeetings <$true | $false>] [-AllowAnonymousUsersToDialOut <$true | $false>] [-AllowConferenceRecording <$true | $false>] [-AllowExternalUserControl <$true | $false>] [-AllowExternalUsersToRecordMeeting <$true | $false>] [-AllowExternalUsersToSaveContent <$true | $false>] [-AllowIPAudio <$true | $false>] [-AllowIPVideo <$true | $false>] [-AllowParticipantControl <$true | $false>] [-AllowPolls <$true | $false>] [-AllowUserToScheduleMeetingsWithAppSharing <$true | $false>] [-AppSharingBitRateKb <Int64>] [-AudioBitRateKb <UInt32>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableAppDesktopSharing <None | SingleApplication | Desktop>] [-EnableDataCollaboration <$true | $false>] [-EnableDialInConferencing <$true | $false>] [-EnableFileTransfer <$true | $false>] [-EnableP2PFileTransfer <$true | $false>] [-EnableP2PRecording <$true | $false>] [-EnableP2PVideo <$true | $false>] [-FileTransferBitRateKb <Int64>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaxMeetingSize <UInt32>] [-MaxVideoConferenceResolution <CIF | VGA>] [-VideoBitRateKb <Int64>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
A conferência é uma parte importante do Microsoft Lync Server 2010: uma conferência permite que um grupo de usuários se reúna 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.
Os valores de propriedade da diretiva podem ser configurados no momento da criação de uma diretiva. Além disso, é possível, a qualquer momento, usar o cmdlet Set-CsConferencingPolicy para modificar os valores de propriedade de uma diretiva existente.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsConferencingPolicy 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-CsConferencingPolicy"}
Parâmetros
Parâmetro | Obrigatório | Tipo | Descrição | ||
---|---|---|---|---|---|
Identity |
Opcional |
Xds Identity |
Identificador exclusivo da diretiva de conferência a ser modificada. As diretivas de conferência podem ser configuradas em escopo global, em escopo de site ou em escopo por usuário. Para modificar a diretiva global, use esta sintaxe: -Identity global. Para modificar uma diretiva de site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Para modificar uma diretiva por usuário, use uma sintaxe semelhante a esta: -Identity SalesConferencingPolicy. Observe que curingas não podem ser usados para especificar Identity. Se nenhuma Identidade for especificada, Set-CsConferencingPolicy modificará automaticamente a diretiva de conferência global. |
||
Instance |
Opcional |
Objeto de diretiva da reunião |
Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais. |
||
AllowAnnotations |
Opcional |
Booleano |
Indica se os participantes têm permissão ou não para fazer anotações na tela ou em qualquer conteúdo compartilhado durante a reunião; esta configuração também define se quadros de comunicações serão permitidos na conferência. O valor padrão é True. Observe que as anotações não são arquivadas com o conteúdo de outra reunião. Esta configuração se aplica ao usuário que organiza a conferência: se for definida como False, as conferências criadas por um usuário afetado por esta diretiva não incluirão anotações. No entanto, o usuário poderá participar de outras conferências nas quais as anotações são permitidas. |
||
AllowAnonymousParticipantsInMeetings |
Opcional |
Booleano |
Indica se os usuários anônimos têm permissão ou não para participar da reunião. Se definida como False, apenas usuários autenticados (ou seja, usuários conectados ao seu Serviços de Domínio Active Directory (AD DS) ou ao Active Directory de um parceiro federado) terão permissão para participar da reunião. O valor padrão é True. Esta configuração se aplica ao usuário que organiza a conferência: se for definida como False, as conferências criadas por um usuário afetado por esta diretiva não permitirão participantes anônimos. No entanto, o usuário poderá participar de outras conferências nas quais participantes anônimos são permitidos. |
||
AllowAnonymousUsersToDialOut |
Opcional |
Booleano |
Indica se os usuários anônimos (por exemplo, usuários não autenticados) têm permissão ou não para ingressar em uma conferência usando telefones. Com os telefones, o servidor de conferência telefonará para o usuário; ao atender o telefone, o usuário ingressará na conferência. Observe que a conferência discada é permitida mesmo se esta configuração estiver definida como False. Esta configuração se aplica ao usuário que organiza a conferência: se for definida como False, as conferências criadas por um usuário afetado por esta política não permitirão que participantes anônimos ingressem na conferência por meio de discagem externa. No entanto, o usuário poderá participar de outras conferências nas quais usuários anônimos possam ingressar por meio de discagem externa. O valor padrão é False ($False). |
||
AllowConferenceRecording |
Opcional |
Booleano |
Indica se os usuários têm permissão para gravar a reunião. O valor padrão é False. Essa configuração se aplica a todos os usuários que tomarem parte da conferência. |
||
AllowExternalUserControl |
Opcional |
Booleano |
Indica se usuários externos (usuários anônimos ou federados) têm permissão para assumir o controle de aplicativos ou áreas de trabalho compartilhados. O valor padrão é False. Esta configuração é aplicada em nível por usuário, e tanto para sessões de comunicação ponto a ponto quanto conferências. Isso significa que alguns usuários em uma sessão podem ter permissão de abrir mão do controle de um aplicativo ou área de trabalho compartilhado para um usuário externo, enquanto outros podem não ter permissão de abrir mão do controle. |
||
AllowExternalUsersToRecordMeeting |
Opcional |
Booleano |
Indica se os usuários externos (anônimos ou federados) têm permissão para gravar a reunião. O valor padrão é False. Esta configuração se aplica ao usuário que organiza a conferência: se for definida como False, as conferências criadas por um usuário afetado por esta diretiva não permitirão que usuários externos gravem conferências. No entanto, o usuário poderá participar de outras conferências nas quais usuários externos tenham permissão para gravar. Observe que essa configuração só entrará em vigor se a propriedade AllowConferenceRecording for definida como True. |
||
AllowExternalUsersToSaveContent |
Opcional |
Booleano |
Indica se usuários externos (ou seja, usuários não conectados à rede no momento) têm permissão ou não para salvar folhetos, slides e outro conteúdo de reunião. O valor padrão é True. Esta configuração se aplica ao usuário que organiza a conferência: se for definida como False, as conferências criadas por um usuário afetado por esta diretiva não permitirão que usuários externos salvem conteúdo. No entanto, o usuário poderá participar de outras conferências nas quais usuários externos tenham permissão para salvar conteúdo. |
||
AllowIPAudio |
Opcional |
Booleano |
Indica se o áudio do computador é permitido ou não na reunião. O valor padrão é True. Esta configuração se aplica ao usuário que organiza a conferência: se for definida como False, as conferências criadas por um usuário afetado por esta diretiva não permitirão áudio IP. No entanto, o usuário poderá participar de outras conferências nas quais o áudio IP é permitido. |
||
AllowIPVideo |
Opcional |
Booleano |
Indica se o vídeo do computador é permitido ou não na reunião. O valor padrão é True. Esta configuração se aplica ao usuário que organiza a conferência: se for definida como False, as conferências criadas por um usuário afetado por esta diretiva não permitirão vídeo IP. No entanto, o usuário poderá participar de outras conferências nas quais o vídeo IP é permitido. |
||
AllowParticipantControl |
Opcional |
Booleano |
Indica se os participantes da reunião têm permissão para assumir o controle dos aplicativos ou áreas de trabalho compartilhados durante a reunião. O valor padrão é True. Esta configuração é aplicada ao usuário que orgnaiza a conferência: se definida para Falso, nenhuma conferência criada pelo usuário afetado por esta política permitirá o controle do participante. No entanto, o usuário pode fazer parte de outras conferências onde o controle de participante é permitido. |
||
AllowPolls |
Opcional |
Booleano |
Indica se os usuários têm permissão para realizar votações online durante uma reunião. O valor padrão é True. Esta configuração se aplica ao usuário que organiza a conferência: se for definida como False, as conferências criadas por um usuário afetado por esta diretiva não permitirão votações. No entanto, o usuário poderá participar de outras conferências nas quais votações sejam permitidas. |
||
AllowUserToScheduleMeetingsWithAppSharing |
Opcional |
Booleano |
Indica se os usuários têm permissão ou não para organizar reuniões que incluam o compartilhamento do aplicativo. O valor padrão é True. Esta configuração se aplica ao usuário que organiza a conferência: se for definida como False, as conferências criadas por um usuário afetado por esta diretiva não permitirão compartilhamento de aplicativos. No entanto, o usuário poderá participar de outras conferências nas quais o compartilhamento de aplicativos seja permitido. |
||
AppSharingBitRateKB |
Opcional |
Inteiro |
Taxa de bits (em quilobytes) usada para o compartilhamento de aplicativos. O valor padrão é 50000. |
||
AudioBitRateKB |
Opcional |
Inteiro |
Taxa de bits (em quilobits) usada para transmissões de áudio. A taxa de bits de áudio pode ser qualquer número inteiro entre 20 e 200, inclusive; o valor padrão é 200. Esta configuração é aplicada em nível por usuário, e tanto para sessões de comunicação ponto a ponto quanto conferências. |
||
Description |
Opcional |
Cadeia de caracteres |
Permite aos administradores fornecer um texto adicional sobre a diretiva de conferência. Por exemplo, a Descrição pode indicar os usuários a que a diretiva deve ser atribuída. |
||
EnableAppDesktopSharing |
Opcional |
PSListModifier |
Indica se os participantes têm permissão ou não para compartilhar aplicativos (ou sua área de trabalho) durante uma reunião. Entre os valores permitidos são: Desktop. Os usuários têm permissão para compartilhar toda a área de trabalho. SingleApplication. Os usuários têm permissão para compartilhar um único aplicativo. None. Os usuários não têm permissão para compartilhar os aplicativos ou a área de trabalho. Esta configuração é aplicada em nível por usuário. Isso significa que alguns usuários em uma conferência podem ter permissão de compartilhar seus aplicativos ou áreas de trabalho, enquanto outros usuários na mesma conferência talvez não tenham permissão de fazer isso. O valor padrão é Desktop. |
||
EnableDataCollaboration |
Opcional |
Booleano |
Indica se os usuários podem organizar reuniões que incluam atividades de colaboração de dados, como quadros de comunicações e anotações. Esta configuração se aplica ao usuário que organiza a conferência: se for definida como False, as conferências criadas por um usuário afetado por esta diretiva não permitirão colaboração de dados. No entanto, o usuário poderá participar de outras conferências nas quais a colaboração de dados seja permitida. |
||
EnableDialInConferencing |
Opcional |
Booleano |
Indica se os usuários podem ou não ingressar na reunião discando com um telefone PSTN (rede telefônica pública comutada). O valor padrão é True. Esta configuração se aplica ao usuário que organiza a conferência: se for definida como False, as conferências criadas por um usuário afetado por esta diretiva não permitirão conferências discadas. No entanto, o usuário poderá participar de outras conferências nas quais a conferência discada seja permitida. |
||
EnableFileTransfer |
Opcional |
Booleano |
Indica se as transferências de arquivos para todos os participantes da reunião são permitidas durante a reunião. O valor padrão é True. Esta configuração se aplica ao usuário que organiza a conferência: se for definida como False, as conferências criadas por um usuário afetado por esta diretiva não permitirão transferências de arquivos. No entanto, o usuário poderá participar de outras conferências nas quais transferências de arquivos sejam permitidas. |
||
EnableP2PFileTransfer |
Opcional |
Booleano |
Indica se as transferências de arquivos ponto a ponto (ou seja, transferências de arquivos que não envolvam todos os participantes) são permitidas durante a reunião. O valor padrão é True ($True). Esta configuração é aplicada em nível por usuário. Isso significa que um usuário em uma sessão de comunicação ponto a ponto pode ter permissão para transferir arquivos, e outro não. |
||
EnableP2PRecording |
Opcional |
Booleano |
Se True, os usuários poderão gravar sessões de conferência ponto a ponto. O valor padrão é False. Esta configuração é aplicada em nível por usuário. Isso significa que um usuário em uma sessão de comunicação ponto a ponto pode ter permissão para gravar a sessão, e outro não. |
||
EnableP2PVideo |
Opcional |
Booleano |
Se True, os usuários poderão participar de sessões de conferência de vídeo ponto a ponto. O valor padrão é False. Esta configuração é aplicada em nível por usuário. Isso significa que um usuário em uma sessão de comunicação ponto a ponto pode ter permissão para usar vídeo, e outro não. |
||
FileTransferBitRateKB |
Opcional |
Inteiro |
Taxa de bits (em quilobytes) usada para transferências de arquivo. O valor padrão é 50000. |
||
MaxMeetingSize |
Opcional |
Inteiro |
Indica o número máximo de pessoas com permissão para participar de uma reunião. Depois que o número máximo de participantes for atingido, qualquer pessoa que tentar ingressar na reunião terá o pedido negado, com um aviso de que a reunião está cheia. O número de participantes especificado neste valor pode ser qualquer número inteiro de 32 bits (qualquer valor entre 1 e 4.294.967.295), mas o tamanho recomendado é entre 2 e 250, inclusive; o valor padrão é 250.
Esta configuração se aplica ao usuário que organiza a conferência: as conferências criadas por um usuário afetado por esta política não permitem um número de participantes maior do que o especificado. No entanto, o usuário pode participar de outras conferências nas quais participantes adicionais são permitidos. |
||
MaxVideoConferenceResolution |
Opcional |
PSListModifier |
Indica a resolução máxima do vídeo da reunião. Os valores permitidos são: CIF. CIF tem uma resolução de 352 pixels por 288 pixels. VGA. VGA tem uma resolução de 640 pixels por 480 pixels. O valor padrão é VGA. |
||
VideoBitRateKB |
Opcional |
Inteiro |
Taxa de bits (em quilobytes) usada para transmissões de vídeo. O valor padrão é 50.000. Esta configuração é aplicada em nível por usuário, e tanto para sessões de comunicação ponto a ponto quanto conferências. |
||
Force |
Opcional |
Parâmetros 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â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
Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Meeting.MeetingPolicy. Set-CsConferencingPolicy aceita instâncias em pipeline do objeto de diretiva de reunião.
Tipos de Retorno
Set-CsConferencingPolicy não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Meeting.MeetingPolicy.
Exemplo
-------------------------- Exemplo 1 --------------------------
Set-CSConferencingPolicy -Identity SalesConferencingPolicy -AllowConferenceRecording $False
O comando anterior modifica um valor de propriedade da diretiva de conferência SalesConferencingPolicy; em especial, o comando define o valor da propriedade AllowConferenceRecording como False. Para isso, Set-CsConferencingPolicy é chamado com o parâmetro Identity e o parâmetro AllowConferenceRecording.
-------------------------- Exemplo 2 --------------------------
Get-CSConferencingPolicy | Set-CSConferencingPolicy -AllowAnonymousParticipantsInMeetings $False -EnableDialInConferencing $False
No Exemplo 2, os mesmos dois valores de propriedade — AllowAnonymousParticipantsInMeetings e EnableDialInConferencing — são modificados para todas as diretivas de conferência configuradas para uso na organização. Para isso, o comando usa inicialmente Get-CsConferencingPolicy para retornar uma coleção de todas as diretivas de conferência disponíveis. Em seguida, essa coleção é redirecionada para Set-CsConferencingPolicy, que define o valor das propriedades AllowAnonymousParticipantsInMeetings e EnableDialInConferencing como False para cada diretiva da coleção.
-------------------------- Exemplo 3 --------------------------
Get-CSConferencingPolicy -Filter "site:*" | Set-CSConferencingPolicy -MaxVideoConferenceResolution CIF
O comando mostrado no Exemplo 3 modifica a propriedade MaxVideoConferenceResolution de todas as diretivas de conferência configuradas no escopo do site. Para realizar essa tarefa, o comando chama inicialmente Get-CsConferencingPolicy e o parâmetro Filter; o valor de filtro "site:*" restringe os dados retornados a diretivas configuradas no escopo do site. Em seguida, essa coleção filtrada é redirecionada para Set-CsConferencingPolicy, que define a propriedade MaxVideoConferenceResolution de cada diretiva na coleção como "CIF".
-------------------------- Exemplo 4 --------------------------
Get-CSConferencingPolicy | Where-Object {$_.MaxMeetingSize -gt 100} | Set-CSConferencingPolicy -MaxMeetingSize 100
O Exemplo 4 recupera todas as diretivas nas quais o tamanho máximo da reunião seja maior do que (-gt) 100 e altera o valor da propriedade associada (MaxMeetingSize) para 100. Para fazer isso, o comando chama inicialmente Get-CsConferencingPolicy para retornar uma coleção de todas as diretivas de conferência configuradas para uso na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que separa apenas as diretivas com um MaxMeetingSize maior do que 100. Em seguida, essa coleção filtrada é redirecionada para Set-CsConferencingPolicy, que seleciona cada diretiva na coleção e define a propriedade MaxMeetingSize como 100.
Consulte Também
Outros Recursos
Get-CsConferencingPolicy
Grant-CsConferencingPolicy
New-CsConferencingPolicy
Remove-CsConferencingPolicy