New-CsMeetingConfiguration

 

Tópico modificado em: 2012-04-23

Cria um novo conjunto de configurações de reunião em escopo do local ou serviço. As configurações de reunião ajudam a ditar os tipos de reuniões (também chamadas de “conferências”) que os usuários podem criar, além de controlar como (ou se) usuários anônimos e usuários de conferência discada podem participar dessas reuniões. Observe que estas configurações afetam apenas as reuniões agendadas; não afetam as reuniões locais criadas clicando na opção Reunir agora no Microsoft Lync.

Sintaxe

New-CsMeetingConfiguration -Identity <XdsIdentity> [-AdmitAnonymousUsersByDefault <$true | $false>] [-AssignedConferenceTypeByDefault <$true | $false>] [-Confirm [<SwitchParameter>]] [-DesignateAsPresenter <None | Company | Everyone>] [-EnableAssignedConferenceType <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-PstnCallersBypassLobby <$true | $false>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

As reuniões (também chamadas de “conferências”) são parte integrante do Microsoft Lync Server 2010. Os cmdlets CsMeetingConfiguration permitem que os administradores controlem os tipos de reuniões que os usuários podem criar e como as reuniões lidam com usuários anônimos e usuários de conferência discada. É possível, por exemplo, configurar as reuniões de modo que qualquer pessoa discando pela PSTN (rede telefônica pública comutada) seja aceita automaticamente na reunião. Outra opção é configurar as reuniões de modo que usuários de discagem não sejam aceitos automaticamente na reunião, mas sim encaminhados para o lobby da reunião. Esses usuários de discagem permanecem esperando no lobby até que um apresentador os aceite na reunião.

Como observado anteriormente, estas configurações afetam apenas as reuniões agendada; não afetam as reuniões locais criadas clicando em Reunir agora no Microsoft Lync. Ao criar uma reunião clicando em Reunir agora, o acesso do participante é aberto automaticamente para todos e os usuários anônimos podem participar da reunião sem precisar aguardar no lobby. Isto ocorre independente de se você definiu as configurações da reunião usando o cmdlet CsMeetingConfiguration.

O cmdlet New-CsMeetingConfiguration permite a criação de novas coleções de configurações de reunião em escopo de site ou serviço (embora apenas para os Serviços do Usuário). Não é possível criar configurações de reunião em escopo global, porque já existe uma coleção global de configurações de reunião.

Observe que cada site ou serviço só pode ter, no máximo, uma coleção de configurações de reunião. Se você tentar criar novas configurações para o site Redmond, e esse site já tiver uma coleção de configurações de reunião, o comando vai falhar.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

Identificador único para a nova coleção de configurações de reunião. As configurações de reunião só podem ser criadas em escopo de site ou serviço. Para criar novas configurações em escopo de site, use uma sintaxe semelhante a esta: -Identity "site:Redmond". Para criar novas configurações em escopo de serviço, use uma sintaxe como esta: -Identity "service:UserServer:atl-cs-001.litwareinc.com".

Observe que a chamada a New-CsMeetingConfiguration irá falhar se o site ou serviço especificado já tiver uma coleção de configurações de reunião.

AdmitAnonymousUsersByDefault

Opcional

Booleano

Determina se as reuniões irão permitir, por padrão, a participação de usuários anônimos (ou seja, não autenticados). Defina esse valor como True se quiser que novas reuniões aceitem por padrão a participação de usuários anônimos. Defina esse valor como False se preferir que novas reuniões não aceitem por padrão a participação de usuários anônimos. O valor padrão é True.

AssignedConferenceTypeByDefault

Opcional

Booleano

Determina se novas reuniões serão configuradas, por padrão, como reuniões públicas. Defina esse valor como True para usar reuniões públicas por padrão; defina-o como False para usar reuniões particulares por padrão. O valor padrão é True.

DesignateAsPresenter

Opcional

Modificador de lista PS

Indica quais usuários (além do organizador da reunião) são designados automaticamente como apresentadores ao ingressar em uma reunião. As opções válidas são: None, Company e Everyone (Nenhum, Empresa e Todos). Por padrão, DesignateAsPresenter está definido como Company, ou seja, qualquer membro da organização tem direitos de apresentador no momento em que ingressam em uma reunião.

EnableAssignedConferenceType

Opcional

Booleano

Indica se os usuários podem agendar reuniões públicas. Em uma reunião pública, a ID de conferência e o link da reunião permanecem consistentes sempre que a reunião ocorre. Em uma reunião particular, a ID de conferência e o link da reunião mudam a cada reunião.

PstnCallersBypassLobby

Opcional

Booleano

Indica se usuários discando por uma linha telefônica PSTN (Rede Telefônica Pública Comutada) devem se aceitos automaticamente em uma reunião. Se estiver definido como True, chamadores por PSTN serão aceitos automaticamente na reunião. Se estiver definido como False, chamadores por PSTN serão roteados inicialmente ao lobby da conferência. Lá eles vão aguardar até que um apresentador da conferência conceda a eles o acesso à reunião. O valor padrão é True.

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.

InMemory

Opcional

Parâmetros de Opção

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.

Tenant

Opcional

Guid

Este parâmetro não é usado com a versão local do Lync Server 2010.

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

Nenhuma. New-CsMeetingConfiguration não aceita dados em pipeline.

Tipos de Retorno

New-CsMeetingConfiguration cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.MeetingConfiguration.

Exemplo

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

New-CsMeetingConfiguration -Identity site:Redmond -EnableAssignedConferenceType $False -AssignedConferenceTypeByDefault $False -AdmitAnonymousUsersByDefault $False

O comando anterior cria uma nova coleção de configurações de reunião para o site Redmond (-Identity site:Redmond). Além de especificar Identity, três parâmetros opcionais estão incluídos neste comando: EnableAssignedConferenceType, AssignedConferenceTypeByDefault e AdmitAnonymousUsersByDefault. Em todos os três casos, esses parâmetros são definidos como False. Isso quer dizer que os tipos de reuniões públicas serão desativados; o tipo de reunião padrão não será definido como reunião pública; e usuários anônimos não serão aceitos em reuniões por padrão.

Observe que esse comando irá falhar se uma coleção de configurações de reunião com Identity site:Redmond já existir. Isso acontece porque apenas uma coleção de configurações de reunião pode ser aplicada a um site específico.

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

$x = New-CsMeetingConfiguration -Identity site:Redmond -InMemory
$x.EnableAssignedConferenceType = $False 
$x.AssignedConferenceTypeByDefault = $False 
$x.AdmitAnonymousUsersByDefault = $False
Set-CsMeetingConfiguration -Instance $x

O Exemplo 2 mostra uma maneira alternativa de criar uma nova coleção de configurações de reunião para o site Redmond; no caso, as configurações são criadas inicialmente apenas na memória, e só depois são aplicadas ao site. Para fazer isso, o primeiro comando do exemplo usa New-CsMeetingConfiguration para criar novas configurações de reunião para o site Redmond. O parâmetro -InMemory é acrescentado ao final do comando para garantir que estas novas configurações sejam criadas somente em memória e não sejam aplicadas imediatamente ao site Redmond (Como essas configurações só existem na memória, elas precisam ser armazenadas em uma variável. No exemplo, elas são armazenadas em uma variável chamada $x).

Depois que essas configurações de reuniões virtuais tiverem sido criadas, os comandos 2, 3 e 4 serão usados para modificar propriedades destas configurações (EnableAssignedConferenceType, AssignedConferenceTypeByDefault e AdmitAnonymousUsersByDefault). No comando final, Set-CsMeetingConfiguration e o parâmetro Instance são usados para aplicar as configurações virtuais ao site Redmond. Observe que essa última etapa é crucial: se você não chamar Set-CsMeetingConfiguration, as novas configurações de reunião nunca serão aplicadas ao site Redmond. Em vez disso, suas configurações virtuais irão desaparecer assim que sua sessão do Windows PowerShell for encerrada ou a variável $x for excluída.