> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Grupos de workspaces

Os **Grupos de workspaces** facilitam o processo de gestão de dispositivos para as organizações, de modo que estas possam agrupá-los de acordo com características compartilhadas ou critérios específicos para monitorar estatísticas de forma mais exaustiva e executar ações efetivas.

<img src="https://mintcdn.com/flexxible/4Y0RO9FhEQKGUaQ2/images/features/wsg-table.png?fit=max&auto=format&n=4Y0RO9FhEQKGUaQ2&q=85&s=06c95b78746f69198aa7a373a9c077b2" alt="wsg-table" width="1000" height="529" data-path="images/features/wsg-table.png" />

Existem três tipos de grupos:

* Estáticos
* Dinâmicos
* Entra ID

## Grupo de workspaces estático

É um grupo criado de forma manual, com critérios livres.

## Grupo de workspaces dinâmico

É um grupo em que se avalia periodicamente alguma condição; por exemplo: "dispositivos com mais de 85% de memória em uso", de forma que seus membros podem mudar em tempo real. É muito útil quando se deseja aplicar ações pontuais sobre eles, como microsserviços para resolver algum problema específico.

<Info>
  Os grupos de workspaces dinâmicos avaliam o cumprimento de uma condição definida a cada 60 minutos; por isso, não são recomendados como mecanismo de detecção de sessões de usuário.
</Info>

## Grupo de workspaces Entra ID

É um grupo que tem a capacidade de se alimentar dos membros de um grupo ou unidade organizacional existente no domínio do Entra ID em uso. A criação desse tipo de grupo requer pelo menos uma integração ativa com o domínio Entra ID, em **Configurações** → **Organização** → **Integrações**.

## Gestão de grupos

A visualização de lista da seção Grupos de workspaces informa sobre o nome dos grupos, de qual tipo são, característica Entra ID e o número de dispositivos que contêm. O botão **Ver detalhe** exibe as seguintes abas:

* Detalhes do grupo de workspaces
* Workspaces
* Histórico
* Localização
* Aplicações instaladas
* Agendamentos
* Sincronizações

### Detalhes do grupo de workspaces

Exibe os mesmos dados da visualização de lista, além da data de criação do grupo e do usuário que o criou. O botão **Editar** permite alterar o nome do dispositivo, adicionar uma descrição ou até excluí-lo.

<img src="https://mintcdn.com/flexxible/4Y0RO9FhEQKGUaQ2/images/features/wsg-detail.png?fit=max&auto=format&n=4Y0RO9FhEQKGUaQ2&q=85&s=f7623124483ed9a15248e34d78373ede" alt="wsg-detail" width="1001" height="284" data-path="images/features/wsg-detail.png" />

### Workspaces

Mostra uma tabela com uma lista dos dispositivos que compõem esse grupo. Informa sobre o Fully Qualified Domain Name (FQDN) do dispositivo, endereço IP, sistema operacional, núcleos de CPU, Random Access Memory (RAM), tipo (físico ou virtual) e último usuário. As opções **Importar Workspaces** e **Editar** só estão disponíveis para os grupos de workspaces estáticos.

<img src="https://mintcdn.com/flexxible/4Y0RO9FhEQKGUaQ2/images/features/wkg-wks.png?fit=max&auto=format&n=4Y0RO9FhEQKGUaQ2&q=85&s=fa2572ec15ab2dbc255d74223a8f0125" alt="wkg-wks" width="1000" height="387" data-path="images/features/wkg-wks.png" />

### Histórico

Exibe um gráfico de barras com a quantidade diária de dispositivos que compuseram o grupo durante o último mês. É possível aproximar o gráfico para uma melhor leitura selecionando com o mouse as barras que se deseja ampliar. Por meio de **Reset zoom**, as informações voltam ao seu estado original.

<img src="https://mintcdn.com/flexxible/4Y0RO9FhEQKGUaQ2/images/features/wkg-history.png?fit=max&auto=format&n=4Y0RO9FhEQKGUaQ2&q=85&s=6bb39d5c3ebc4a39102f6429139f1d27" alt="wkg-history" width="999" height="392" data-path="images/features/wkg-history.png" />

### Localização

Permite associar coordenadas GPS ao grupo de workspaces para relacioná-lo a um ponto no mapa. Esse valor é apenas uma referência; não é atualizado se os usuários mudarem de localização.

<img src="https://mintcdn.com/flexxible/4Y0RO9FhEQKGUaQ2/images/features/wkg-loc.png?fit=max&auto=format&n=4Y0RO9FhEQKGUaQ2&q=85&s=08178cc3c1c5e6ccd890b659f665ecab" alt="wkg-loc" width="1000" height="409" data-path="images/features/wkg-loc.png" />

### Aplicações instaladas

Esta aba exibe a lista de todas as aplicações instaladas nos dispositivos que pertencem ao grupo de workspaces selecionado.

<img src="https://mintcdn.com/flexxible/0bqWyUsDicufj280/images/features/wkg-instApps.png?fit=max&auto=format&n=0bqWyUsDicufj280&q=85&s=4ec3782c9d911540151a5a63c3778748" alt="wkg-instApps" width="1000" height="545" data-path="images/features/wkg-instApps.png" />

A tabela inclui os seguintes campos:

* **Aplicação.** Nome da aplicação instalada. Clicável. Redireciona para sua visualização de detalhe.
* **Editor.** Empresa desenvolvedora da aplicação.
* **Versão.** Número de versão instalada.
* **Sistema operacional.** Sistema operacional dos dispositivos nos quais a aplicação está instalada.
* **Workspaces.** Número de dispositivos do grupo nos quais a aplicação está instalada. Clicável. Redireciona para a [aba Workspaces](../apps/software/installed-apps), dentro da visualização de detalhe da aplicação.

Em grupos de workspaces com um volume elevado de dispositivos, o processamento necessário para calcular e exibir essas informações pode exigir mais tempo de carregamento.

Devido a esse volume de dados, o número total de dispositivos nos quais cada aplicação está instalada não é calculado em tempo real. Esse valor é atualizado automaticamente a cada duas horas, portanto é possível que as alterações recentes não se reflitam de forma imediata.

### Agendamentos

Essa funcionalidade permite configurar ações recorrentes sobre o grupo de workspaces quando é necessário que uma mesma ação seja executada várias vezes na semana dentro de um único agendamento.

Nesta aba é possível agendar as seguintes ações:

* Wake on LAN (WoL)
* Desligar
* Reiniciar

Para criar um agendamento:

1. Acessar **Workspaces** → **Grupos de Workspaces**.
2. Na tabela, selecionar um grupo de workspaces.
3. Ir à aba **Agendamentos**.
4. Clicar em **Novo** e preencher o formulário com os seguintes campos:

<img src="https://mintcdn.com/flexxible/0bqWyUsDicufj280/images/features/sched-cron-new.png?fit=max&auto=format&n=0bqWyUsDicufj280&q=85&s=1c6d5b67417c7e6a1020bb8a996a4d8e" alt="sched-cron-new" width="1000" height="518" data-path="images/features/sched-cron-new.png" />

* **Ação.** *Wake on LAN* ou *Desligamento*.

  Ao escolher *Wake on LAN*, é habilitada a opção **Usar workspace específico para WoL**, que permite realizar a inicialização por meio de um dispositivo específico.

* **Agendamento.**
  * **Hora de início.** Hora em que a ação será executada.
  * **Padrão de recorrência**
    * **Semanal.** Seleção de um ou vários dias da semana em que a ação será executada.
  * **Fuso horário.** Fuso horário utilizado como referência para a execução da ação.

5. Clicar em **Salvar**.

Os agendamentos criados são exibidos em uma tabela com as informações configuradas, o usuário que criou o agendamento e os dados da última atualização.

Por meio de **Ver detalhe** é possível editar ou excluir o agendamento.

### Sincronizações

Esta aba só é visível quando o grupo é do tipo Entra ID. Exibe uma tabela com detalhes das sincronizações realizadas com informações sobre:

* Data e hora da sincronização.
* **Workspaces do Entra ID.** Número total de elementos no grupo ou na unidade organizacional do Entra ID.
* **Workspaces adicionados.** Número de dispositivos adicionados ao grupo.
* **Workspaces removidos.** Número de dispositivos removidos do grupo.
* **Workspaces existentes.** Número de dispositivos que já estavam no grupo.
* **Workspaces não encontrados.** Número de dispositivos não encontrados no grupo; ou seja, dispositivos que, embora façam parte do grupo ou unidade organizacional do Entra ID, ao não terem o FlexxAgent instalado, não podem ser adicionados ao grupo.
* **Workspaces duplicados.** Número de workspaces duplicados no grupo, se houver.
* **Hora de execução.** Tempo que a sincronização levou.
* **Ação.** Permite ver uma tabela com informações de sincronização de cada dispositivo do grupo.

  <img src="https://mintcdn.com/flexxible/4Y0RO9FhEQKGUaQ2/images/features/sync.png?fit=max&auto=format&n=4Y0RO9FhEQKGUaQ2&q=85&s=a860c2524cb5df6b387d3e5bf4f857b8" alt="sync" width="854" height="454" data-path="images/features/sync.png" />

## Criação de grupos

Na parte superior da visualização de lista da seção **Grupos de workspaces**, deve-se clicar em **Novo**. Será aberto um formulário no qual será solicitado adicionar um nome e uma descrição para o novo grupo.

<img src="https://mintcdn.com/flexxible/0bqWyUsDicufj280/images/features/newwe.png?fit=max&auto=format&n=0bqWyUsDicufj280&q=85&s=4d3557f3208a3ef0beed2c06a8245e60" alt="newwe" width="599" height="330" data-path="images/features/newwe.png" />

Há duas maneiras de adicionar dispositivos a um grupo de workspaces estático:

1. Na tabela de grupos, deve-se clicar em **Visualização de detalhe** do grupo desejado → **Workspaces** → **Importar dispositivos**. É aberto um formulário que permite importar até 20 mil dispositivos.

<img src="https://mintcdn.com/flexxible/4Y0RO9FhEQKGUaQ2/images/features/import-wks-group.png?fit=max&auto=format&n=4Y0RO9FhEQKGUaQ2&q=85&s=3f1e86a8b351a7e65f9f287670808c27" alt="import-wks-group" width="854" height="380" data-path="images/features/import-wks-group.png" />

2. Na tabela de grupos, deve-se clicar em **Visualização de detalhe** do grupo desejado → **Workspaces** → **Editar**. Em seguida, selecionar os dispositivos que se deseja adicionar. Os marcados com um ponto laranja são adicionados ao grupo e os que não estão marcados são removidos. Em ambos os casos, para conservar as alterações deve-se clicar em **Salvar**.

<img src="https://mintcdn.com/flexxible/4Y0RO9FhEQKGUaQ2/images/features/wsg-static-edit.png?fit=max&auto=format&n=4Y0RO9FhEQKGUaQ2&q=85&s=f5cb44dd38f5b50882e8bf1e50573646" alt="wsg-static-edit" width="1000" height="321" data-path="images/features/wsg-static-edit.png" />

<Info>
  As organizações podem importar para um grupo de workspaces estático os dispositivos que fazem parte de suas suborganizações.
</Info>

### Criar um grupo de workspaces Entra ID

No menu lateral, acessar **Grupos de workspaces.** Clicar em **Novo**. Será aberto um formulário no qual se deve adicionar um nome, uma descrição para o grupo e ativar o botão **Entra ID**. Em seguida, selecionar o tipo de grupo que será criado: **Entra ID Group** ou **Entra ID Administration Unit**.

Os grupos Entra ID exigem uma conexão via API, que pode ser configurada a partir de **Configurações** → **Organização** → **Chave de API**. Somente a partir daí será possível consultar os **Entra ID Group** e as **Entra ID Administration Unit** criados.

### Excluir um grupo de workspaces

Na visualização de lista da seção Grupos de workspaces, deve-se clicar em **Visualização de detalhe** do grupo desejado. Na aba **Detalhe do grupo** → **Editar**, será aberto um formulário com a opção **Excluir**.
