Como configurar o Zoom Rooms com o Office 365

Quando um recurso de calendário é integrado a uma Zoom Room, a tela de TV da sala, o controlador e a exibição de agendamento mostram as reuniões agendadas para a sala. Os membros da sua organização podem agendar uma reunião em uma Zoom Room convidando a sala para a reunião. As salas de conferência são atribuídas como um recurso de calendário através de um serviço de calendário. Autorizar a Zoom a ter acesso aos recursos de calendário permite que os usuários iniciem e ingressem em reuniões na sala com apenas um toque.

Antes de adicionar um serviço de calendário para o Zoom Rooms, um administrador do Office 365 deve criar um usuário dedicado no Office 365 para gerenciar calendário, criar ou localizar um recurso de calendário para cada Zoom Room e, em seguida, configurar o usuário e o recurso usando o acesso de representação ou delegado.

Após o administrador do Office 365 concluir todas as etapas de cada seção, as credenciais do usuário dedicado serão usadas, em seguida, para fornecer autorização para que o Zoom Rooms use o serviço de calendário e todos os seus recursos de calendário na sua conta.

Este artigo abrange:

Como criar um usuário dedicado para o Zoom acessar os calendários do Office 365
Como criar ou localizar um recurso de calendário para cada sala
Como configurar as permissões de acesso
- Representação no nível do aplicativo
- Acesso delegado completo
Como atualizar as configurações do recurso de calendário usando o Windows PowerShell
Como adicionar um serviço de calendário ao Zoom

Pré-requisitos para configurar o Zoom Rooms com o Office 365

Uma conta de Administrador do Office 365 com permissão para criar um novo usuário
A capacidade de criar e gerenciar calendários para salas
Acesso de administrador para o Windows PowerShell

Como criar um usuário dedicado para o Zoom acessar os calendários do Office 365

Inicie sessão no Office 365 como administrador.
Adicione um usuário na sua conta Office 365. Consulte a documentação da Microsoft Adicione usuários ao Office 365 para instruções.
Observação: Em razão da necessidade do usuário dedicado ter uma caixa de correio, o usuário deve ser um usuário licenciado no Office 365.
Tome nota do endereço de e-mail e da senha.
Prossiga para a próxima seção para criar ou localizar um recurso de calendário para cada sala.

Como criar ou localizar um recurso de calendário para cada sala

Inicie sessão no Microsoft Exchange admin center (EAC) como administrador.
No menu de navegação, clique em Recipients [Destinatários] e, em seguida, Resources [Recursos.
Clique no sinal de mais (+) caso precise adicionar uma sala.
O Zoom recomenda que você use um prefixo (como ZR) para cada sala ou escolha o seu próprio método para localizar facilmente o Zoom Rooms.
Tome nota do nome de exibição e do endereço de e-mail de cada recurso de calendário.
Prossiga para a próxima seção para vincular o usuário e os recursos ao Zoom, por meio da Representação no nível de aplicativo ou usando o Acesso Delegado Completo.

Como configurar as permissões de acesso

Representação no nível do aplicativo

Habilite a representação do aplicativo no EAC

Inicie sessão no Microsoft Exchange admin center (EAC) como administrador.
No menu de navegação, clique em Permissions [Permissões].
Selecione Discovery Management [Gerenciamento de Descoberta e, em seguida, clique em Edit [Editar].
Em Roles [Funções], clique no ícone de adicionar (+).
Na lista de endereços, selecione ApplicationImpersonation e, em seguida, clique em add [adicionar].
Clique em OK.
Clique em Save [Salvar] em Gerenciamento de Descoberta.
Agora, o Office 365 começará a atualizar as configurações da organização.

Atualize o gerenciamento de função e atribuições

Inicie o Windows PowerShell usando a opção "Executar como administrador".
Observação: Essa opção está disponível quando você clica com o botão direito do mouse no aplicativo Windows PowerShell sem executá-lo.
Insira o seguinte comando:
```
$UserCredential = Get-Credential
```
Insira o usuário e senha do administrador do Office 365 na caixa de diálogo.
Certifique-se de que essa conta tenha permissões tanto para "Gerenciamento da Organização" quanto para "Gerenciamento de Destinatário".

Prepare a sessão executando o seguinte comando:

$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://outlook.office365.com/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection

Observação: se você está na China, o comando a ser inserido é ligeiramente diferente. Insira o seguinte:

$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://partner.outlook.cn/powershell-liveid/ -Credential $UserCredential -Authentication Basic -AllowRedirection

Conecte a sessão usando o seguinte comando.
```
Import-PSSession $Session
```
Caso você veja uma mensagem que começa com "If you see an error like “Import-PSSession: Files cannot be loaded… [Se você vir um erro como "Import-PSSession: os arquivos não podem ser carregados...]" digite o seguinte comando:
```
Set-ExecutionPolicy Unrestricted
```
Observação: note que este comando não funcionará se você não estiver executando o Windows PowerShell como administrador, conforme exigido na etapa 1.
Execute o seguinte comando para criar uma nova função de gerenciamento.
```
New-ManagementRoleAssignment -Role:ApplicationImpersonation -User: "DedicatedUser"
```
Observação: para DedicatedUser, digite o endereço da caixa de correio do serviço dedicado do usuário da conta.

Execute o seguinte comando para criar o escopo de permissão.

New-ManagementScope -Name "ResourceMailboxes" -RecipientRestrictionFilter {RecipientTypeDetails -eq "RoomMailbox" -or RecipientTypeDetails -eq "EquipmentMailbox" -or Name -eq 'DedicatedUser'}

Execute o seguinte comando para criar um relacionamento entre a conta e o escopo.
```
New-ManagementRoleAssignment –Name "ResourceImpersonation" –Role ApplicationImpersonation –User "DedicatedUser" –CustomRecipientWriteScope "ResourceMailboxes"
```
Observação: para DedicatedUser, digite o endereço da caixa de correio do serviço dedicado do usuário da conta.

Adicione os calendários do recurso ao usuário dedicado

Inicie sessão como usuário dedicado no Outlook Web.
Acesse Calendars [Calendários].
Clique em Import Calendar [Importar Calendário].
Clique em From directory [Do diretório].
Em Add calendar from directory [Adicionar calendário a partir do diretório], procure pelo endereço da caixa de correio do recurso.
Clique em Adicionar.

Acesso delegado completo

Delegue salas ao usuário dedicado

Inicie sessão no Microsoft Exchange admin center (EAC) como administrador.
No menu de navegação, clique em Recipients [Destinatários] e, em seguida, Resources [Recursos.
Dê dois cliques no nome de uma sala.
Clique em mailbox delegation [delegação de caixa de correio].
Ao lado de Send As [Enviar como], clique no sinal de mais (+).
Selecione o usuário dedicado e clique em add-> [adicionar->].
Clique em OK.
Role para baixo até Full Access [Acesso Completo] e clique no sinal de mais (+).
Selecione o usuário dedicado e clique em add-> [adicionar->]
Clique em OK.
Clique em Salvar.
Repita as etapas de 3 a 11 para cada sala.
Prossiga para a próxima seção para habilitar o usuário dedicado para editar os calendário do Zoom Rooms.

Habilite o usuário dedicado para editar os calendários do Zoom Rooms

Inicie sessão em https://login.microsoftonline.com com o e-mail do usuário dedicado (como zoomroomadmin@mycompany.com)
Abra o "Calendário" do usuário dedicado e na navegação superior, clique no nome do usuário dedicado para abrir um menu suspenso.
Escolha "Open another mailbox... [Abra outra caixa de correio...]"

Isso exibirá uma caixa de diálogo pop-up do Microsoft.
Digite o nome do recurso do calendário que você criou.
Isto abrirá a caixa de correio do recurso de calendário.
Clique no calendário no canto inferior esquerdo do painel de navegação para o recurso de calendário.
Clique com o botão direito do mouse em Calendar [Calendário], em "My Calendars" [Meus Calendários] e escolha Sharing Permissions [Compartilhar Permissões].
Isto abrirá a caixa de diálogo Share this calendar: Calendar [Compartilhar este calendário: Calendário]
Digite o e-mail para o usuário dedicado, escolha Can edit [Pode editar] no menu e, em seguida, clique em Share [Compartilhar].
Abra a caixa de correio do usuário dedicado e aceite o convite do recurso do calendário.
Isto abre a aba Calendário.
Certifique-se de que você consegue visualizar o recurso de calendário listado no lado esquerdo da página em Other Calendars [Outros Calendários] > People's Calendars [Calendário das Pessoas].
Prossiga para a próxima sessão para atualizar as configurações do recurso de calendário usando o Windows PowerShell.

Como atualizar as configurações do recurso de calendário usando o Windows PowerShell

Para que o Zoom possa exibir as informações do calendário e gerar um link de acesso para as reuniões Zoom, é preciso atualizar as configurações do recurso do calendário.

Inicie o Windows PowerShell usando a opção "Executar como administrador".
Essa opção está disponível quando você clica com o botão direito do mouse no aplicativo Windows PowerShell sem executá-lo.
Insira o seguinte comando:
```
Connect-ExchangeOnline -UserPrincipalName <UPN>
```
Observação: altere o valor do <UPN> para o nome de usuário do administrador do Office 365. Certifique-se de que essa conta tenha permissões tanto para "Gerenciamento da Organização" quanto para "Gerenciamento de Destinatário".

Prepare a sessão executando o seguinte comando:

Connect-ExchangeOnline -ExchangeEnvironmentName O365Default -ConnectionUri https://outlook.office365.com/powershell-liveid/

Confira as configurações para o recurso do calendário digitando o seguinte comando, alterando o valor "room_name" para o valor real do nome da sala:

Get-CalendarProcessing -Identity "room_name"| Format-List Identity,DeleteComments,DeleteSubject,AddOrganizerToSubject,RemovePrivateProperty,DeleteAttachments

Verifique as respostas para os seguintes valores:
"DeleteSubject", "AddOrganizerToSubject", "DeleteComments", "RemovePrivateProperty", e "DeleteAttachments"
Na maioria das vezes, estes valores estão definidos como True [Verdadeiro].
```
Identity              : portertest.com/Users/room_name
DeleteSubject         : True
AddOrganizerToSubject : True
DeleteComments        : True 
RemovePrivateProperty : True
DeleteAttachments     : True
```
Altere as configurações da sala com o seguinte comando, alterando o valor "room_name" para o nome real da sala.
```
Set-CalendarProcessing -Identity "room_name" -AddOrganizerToSubject $false -OrganizerInfo $true -DeleteAttachments $true -DeleteComments $false -DeleteSubject $false -RemovePrivateProperty $false
```
Após executar estes comando, as seguinte configurações serão definidas:
```
Identity              : portertest.com/Users/room_name
DeleteSubject         : False
AddOrganizerToSubject : False
DeleteComments        : False
RemovePrivateProperty : False
```
Observações:
- Caso não queira mostrar o assunto Calendário, altere DeleteSubject $false para DeleteSubject $true
- Caso você veja um erro como "The operation couldn't be performed because object 'Room' couldn't be found on 'zoomwithus.onmicrosoft.com'. [A operação não pode ser executada porque o objeto 'Room' não pode ser encontrado em 'zoomwithus.onmicrosoft.com], isso significa que o grupo de escopo de função que dá permissão para executar o cmdlet não inclui o user/room [usuário/sala]. Certifique-se de está logado com uma conta de administrador, conforme exigido na etapa 3.
- Caso você veja um erro como “Set-CalendarProcessing command not found” [Comando Set-Calendar-Processing não encontrado], certifique-se de que a conta de administrador que você utilizou para efetuar login no PowerShell tenha permissões em "Gerenciamento da Organização" e "Gerenciamento de Destinatários".
Confira as configurações da sala após alterar as configurações com o seguinte comando, mudando o valor de "room_name" para o nome real da sala.
```
Get-CalendarProcessing -Identity "room_name" | Format-List identity,deletesubject,addorganizertosubject,DeleteComments,RemovePrivateProperty
```

Verifique se as respostas para os seguintes valores foram alterados para Falso:
"DeleteSubject", "AddOrganizerToSubject", "DeleteComments" e "RemovePrivatePropoerty"

Identity              : portertest.com/Users/room_name
DeleteSubject         : False
AddOrganizerToSubject : False
DeleteComments        : False
RemovePrivateProperty : False

Repita as etapas de 4 a 8 para cada calendário, alterando apenas o nome da sala em cada comando.
Desconecte a sessão com o seguinte comando:
```
Disconnect-ExchangeOnline
```
Feche o Windows PowerShell.

Como adicionar um serviço de calendário ao Zoom

Inicie sessão no Zoom Web Portal como um administrador do Zoom Rooms.
Escolha Calendar Integration [Integração de Calendário] e, em seguida, clique em Add Calendar Service [Adicionar Serviço de Calendário].
A caixa de diálogo Add a Calendar Service [Adicionar um Serviço de Calendário] é exibida.
Clique em Office 365.
Escolha Authorize with EWS [Autorizar com EWS] ou Authorize with OAuth 2.0 [Autorizar com OAuth 2.0]. Caso queira saber mais sobre essas opções, consulte essa documentação da Microsoft.
- Caso escolha Authorize with EWS [Autorizar com EWS], digite o endereço de e-mail e senha do usuário dedicado para o serviço de calendário, assim como o URL do EWS.
- Caso escolha Authorize with OAuth 2.0 [Autorizar com OAuth 2.0], digite o URL do EWS.
Em Account Permission Type [Tipo de Permissão da Conta], selecione App-level Impersonation [Representação no nível do Aplicativo] ou Full Access Delegate [Acesso Delegado Completo], dependendo de qual configuração de permissão acima você utilizou.
Clique em Authorize [Autorizar].
Observação: Caso esteja usando OAuth 2.0 e usuários do Office 365 consentem que os aplicativos empresariais acessem dados da empresa em seu nome estiver desabilitada nas Configurações da Conta, essa opção precisará ser habilitada nas configurações ou habilitada para o Zoom app no Azure.
A página integração de calendário exibe o serviço de calendário que você adicionou.

Observação: Consulte Adicionar uma Zoom Room para informações sobre como configurar um recurso de calendário com uma Zoom Room.