> ## 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.

# Integração com o Microsoft Configuration Manager (SCCM)

A integração com o Microsoft Configuration Manager, também conhecido como SCCM, permite automatizar o diagnóstico e a manutenção do seu cliente nos computadores Windows gerenciados com o FlexxClient. Ao ativá-la, são criados os fluxos e os microsserviços necessários para gerenciar a saúde do cliente, as políticas, os inventários e a avaliação das implantações existentes.

Os microsserviços utilizam a capacidade de execução do FlexxAgent nos dispositivos. Os [fluxos](https://docs.flexxible.com/pt-BR/features/flows/flows) determinam quando são executados e em quais computadores.

> [!NOTE]
>
> A integração automatiza as operações locais do cliente SCCM com a capacidade de execução existente do FlexxAgent. A sincronização de coleções, as consultas centrais ao servidor e a instalação ou desinstalação do cliente SCCM não fazem parte do seu escopo.

## Automações que a integração cria

| Fluxo | Função dos microsserviços associados |
| - | - |
| **Saúde do cliente** | Verificar o cliente SCCM, detectar problemas locais e aplicar as recuperações habilitadas. |
| **Políticas de máquina** | Solicitar a recuperação e a avaliação das políticas atribuídas ao computador. |
| **Inventários** | Solicitar os ciclos de inventário de hardware e software configurados no SCCM. |
| **Avaliação de implantações** | Solicitar a reavaliação das atribuições existentes de aplicativos e atualizações. |

## Requisitos

* Computadores Windows gerenciados com o FlexxClient e com o FlexxAgent operacional.
* Cliente SCCM instalado e configurado para executar as ações do Configuration Manager.
* Permissões para gerenciar a integração, configurar fluxos e executar microsserviços de dispositivo.
* Conectividade do cliente SCCM com a sua infraestrutura para as operações que precisam dela.

> [!NOTE]
>
> Em computadores cogerenciados com o Intune, habilite as automações de acordo com as [cargas de trabalho](https://learn.microsoft.com/mem/configmgr/comanage/workloads) que continuam sob o gerenciamento do Configuration Manager.

## Ativar a integração

1. Acessar **Configuração** → **Integrações** → **Microsoft Configuration Manager (SCCM)**.
2. Selecionar a organização na qual se deseja disponibilizar as automações do SCCM.
3. Ativar a integração. O FlexxClient cria os fluxos e os microsserviços associados ao pacote.
4. Revisar os recursos criados antes de colocá-los em funcionamento.
5. Executar o microsserviço de diagnóstico nos computadores piloto e revisar os resultados antes de aplicar correções.
6. Configurar cada fluxo:
   * **Destinos.** Dispositivos, grupos de workspaces ou grupos de relatório que recebem a automação. Comece por um grupo piloto representativo.
   * **Condições e programação.** Quando o fluxo é executado e o tempo mínimo entre execuções.
   * **Recuperações.** Ações de recuperação que se deseja habilitar.
7. Habilitar os fluxos necessários depois de validado o seu comportamento no grupo piloto e ampliar gradualmente os computadores de destino.

> [!NOTE]
>
> Os fluxos são criados desabilitados. O pacote inclui um microsserviço de diagnóstico que consulta o estado do cliente sem aplicar correções.

> [!WARNING]
>
> **Detection only** avalia as condições do fluxo sem executar as suas ações. Se o diagnóstico do SCCM estiver dentro de um microsserviço, esse modo não o executa. Para verificar o cliente, utilize o microsserviço de diagnóstico.

## Como funciona cada execução

Cada automação segue o mesmo ciclo operacional:

1. **Verificar.** O microsserviço revisa os pré-requisitos e o estado local do cliente SCCM.
2. **Determinar se é necessário agir.** Se a verificação não detectar a condição prevista, termina sem executar a correção.
3. **Executar a ação habilitada.** O microsserviço utiliza as interfaces locais do cliente para solicitar a operação correspondente.
4. **Verificar e registrar.** Coleta o resultado da solicitação e, quando é possível verificar, a evidência posterior no computador. Se for necessária uma revisão, indica isso na saída.

## Funcionamento das automações

### Saúde do cliente

O diagnóstico verifica a presença do cliente, o estado do serviço SMS Agent Host (`CcmExec`) e o acesso às interfaces locais de que as ações precisam. Identifica os problemas que impedem o cliente de funcionar e fornece informações úteis para o suporte.

Se o serviço estiver parado e a recuperação estiver habilitada, o microsserviço o inicia e verifica novamente o seu estado. A Microsoft documenta essa verificação como parte das [verificações de saúde do cliente](https://learn.microsoft.com/mem/configmgr/core/clients/manage/client-health-checks).

Se o cliente não estiver instalado, estiver danificado ou a recuperação não resolver o problema, o resultado indica que é necessária uma intervenção. A instalação ou reinstalação do cliente e os reparos profundos do Windows ficam fora do escopo desta integração.

### Políticas de máquina

O fluxo solicita ao cliente a recuperação e a avaliação das políticas de máquina por meio das ações locais do Configuration Manager. Permite revisar computadores que não processam corretamente as suas políticas.

A verificação distingue a solicitação aceita da evidência de que a política foi processada. As atribuições e o conteúdo das políticas continuam sendo gerenciados no SCCM.

### Inventários de hardware e software

O fluxo solicita os ciclos de inventário de hardware e software do cliente SCCM. Cada ciclo utiliza a configuração que o cliente tem atribuída no Configuration Manager.

O resultado informa sobre a solicitação e a evidência local disponível. Para confirmar a atualização no servidor, verifique no SCCM o recebimento e o processamento do inventário.

### Avaliação de implantações

O fluxo solicita a reavaliação das atribuições existentes de aplicativos e atualizações de software por meio das ações do cliente do Configuration Manager.

O SCCM continua controlando as atribuições, os prazos, o conteúdo, as [janelas de manutenção](https://learn.microsoft.com/mem/configmgr/core/clients/manage/collections/use-maintenance-windows) e o comportamento das reinicializações. A reavaliação pode dar origem a ações sobre implantações já atribuídas, de acordo com essa configuração e as suas exceções.

> [!WARNING]
>
> Antes de habilitar esta automação, revise as implantações do grupo piloto e o efeito que uma reavaliação pode ter sobre os computadores.

## Consultar os resultados

1. Acessar **Operações**.
2. Abrir o detalhe da operação.
3. Consultar a saída do microsserviço na aba **Workspaces**.
   A saída identifica o computador, a verificação realizada, a ação solicitada e o resultado da verificação local. Os problemas que precisam de intervenção incluem uma descrição que permite continuar o diagnóstico.

| Evidência disponível | Como interpretá-la |
| - | - |
| **Solicitação retornada corretamente** | A chamada para iniciar a ação foi bem-sucedida. Por si só, não confirma que o ciclo completo tenha terminado. |
| **Resultado verificado no computador** | A verificação posterior comprova um resultado local concreto, como o serviço estar novamente em execução. |
| **Verificação pendente** | A ação foi solicitada, mas ainda não há evidência suficiente para confirmar o seu resultado. |
| **Erro ou condição não aplicável** | A solicitação falhou ou o computador não cumpre os pré-requisitos. Revise o motivo antes de repeti-la. |

> [!NOTE]
>
> Uma resposta bem-sucedida do método [`TriggerSchedule`](https://learn.microsoft.com/mem/configmgr/develop/reference/core/clients/client-classes/triggerschedule-method-in-class-sms_client) comprova o sucesso da chamada, mas não a conclusão do ciclo nem a atualização dos registros do servidor. Confirme no Configuration Manager os resultados que dependem do servidor.

## Resolver os problemas habituais

* **O fluxo não age.** Verifique se ele está habilitado, se o computador está dentro do escopo e se as condições são cumpridas. Verifique também **Detection only** e o tempo mínimo entre execuções.
* **O microsserviço não pode ser executado.** Verifique a disponibilidade do FlexxAgent, as permissões e os pré-requisitos indicados na saída.
* **O cliente SCCM não está operacional.** Verifique o serviço, os registros locais e a conectividade com a infraestrutura do Configuration Manager.
* **A solicitação está correta, mas o SCCM não mostra o resultado.** Verifique o ciclo local e o processamento no servidor antes de repetir a ação.

## Gerenciar ou interromper as automações

Você pode ajustar o escopo e a configuração de cada fluxo:

* Para interromper uma automação específica, desabilite o seu fluxo.
* Para interromper todas as automações administradas pela integração, desative a integração.
  A desativação impede novas execuções e cancela as solicitações que continuam na fila da plataforma e que ainda não foram enviadas ao dispositivo. As solicitações já enviadas podem ser concluídas, e as operações que o cliente SCCM já aceitou continuam sob o seu controle.

## Gerenciar os recursos da integração

O FlexxClient vincula os fluxos e os microsserviços do pacote à integração. A sua configuração é preservada durante a desativação e a reativação.

* **Ativação e reativação.** Ativar novamente uma integração que já está ativa não duplica os seus recursos nem modifica a sua configuração. Ao reativar uma integração desativada, os seus recursos são reutilizados e os fluxos permanecem desabilitados até que você volte a habilitá-los.
* **Computadores que recuperam a conexão.** Não recebem as solicitações pendentes que foram canceladas ao desativar a integração, e a reativação não as recupera. As novas execuções dependem dos fluxos habilitados e das suas condições.
* **Personalizações.** As cópias personalizadas são gerenciadas de forma independente: não recebem as atualizações do pacote nem são desabilitadas ao desativar a integração. Revise-as e interrompa-as separadamente quando necessário.
* **Atualizações.** As atualizações do pacote preservam o escopo, a programação e os parâmetros configurados. Não habilitam fluxos desabilitados nem ampliam os computadores de destino, e os novos fluxos são criados desabilitados. Se um recurso contiver alterações locais, a atualização não as sobrescreve automaticamente; revise-as antes de aplicar a nova versão.
* **Execução manual.** A execução manual dos microsserviços continua sujeita às permissões da plataforma e ao estado de cada microsserviço.

## Informações relacionadas

* [Automatizar a execução de microsserviços](https://docs.flexxible.com/pt-BR/guides/ms-exec-flow.md)
* [Executar microsserviços em dispositivos](https://docs.flexxible.com/pt-BR/guides/msecexwls.md)
* [Fluxos](https://docs.flexxible.com/pt-BR/features/flows/flows)
* [Operações](https://docs.flexxible.com/pt-BR/features/traceability/operations/operations)
* Microsoft Learn: [Verificações de saúde do cliente](https://learn.microsoft.com/mem/configmgr/core/clients/manage/client-health-checks)
* Microsoft Learn: [Método TriggerSchedule da classe SMS\_Client](https://learn.microsoft.com/mem/configmgr/develop/reference/core/clients/client-classes/triggerschedule-method-in-class-sms_client)
* Microsoft Learn: [Uso de janelas de manutenção](https://learn.microsoft.com/mem/configmgr/core/clients/manage/collections/use-maintenance-windows)
* Microsoft Learn: [Cargas de trabalho de cogerenciamento](https://learn.microsoft.com/mem/configmgr/comanage/workloads)
* Microsoft Learn: [Notificação de cliente](https://learn.microsoft.com/mem/configmgr/core/clients/manage/client-notification)
